@memberjunction/livekit-room-server 6.2.0-edge.3 → 6.2.0-edge.5

package/dist/livekit-agent-room-coordinator.js

@@ -1,10 +1,12 @@
 /**
  * @fileoverview {@link LiveKitAgentRoomCoordinator} — the server-side **session-start harness** for the
  * MJ-native LiveKit room (§1 of the realtime-bridge buildout plan). Given an agent + a room, it:
- *   1. mints the agent bot's scoped LiveKit token ({@link LiveKitTokenService}),
- *   2. opens the realtime model session via an injectable {@link RealtimeSessionFactory} seam, and
+ *   1. opens the realtime model session via an injectable {@link RealtimeSessionFactory} seam,
+ *   2. mints the agent bot's scoped LiveKit token ({@link LiveKitTokenService}), whose attributes depend on the session, and
  *   3. bridges that session into the room through {@link AIBridgeEngine.StartBridgeSession} (which wires
  *      the transport seam + turn-taking automatically).
+ * A start that fails after step 1 closes the model session before the error propagates, recording the failure on the
+ * agent's co-agent run first ({@link FailedStartRecorder}).
  *
  * The realtime-session factory is a seam (mirroring `LiveKitBridge.SetSdkFactory`): production binds it to
  * the real model-resolution path (`@memberjunction/ai-agents`), and tests/de-risk inject a stub session.
@@ -12,14 +14,38 @@
  *
  * @module @memberjunction/livekit-room-server
  */
-import { BaseSingleton } from '@memberjunction/global';
+import { BaseSingleton, NormalizeUUID, UUIDsEqual } from '@memberjunction/global';
 import { LogError, LogStatus } from '@memberjunction/core';
+import { AgentAvatarAttributes, AgentParticipantIdentity, AgentWatchesAttributes, InboundVideoStreamsOf, ResolveIsModelFullDuplex, } from '@memberjunction/ai';
+import { DefaultNativeLoader } from '@memberjunction/ai-bridge-livekit';
+import { AIEngine } from '@memberjunction/aiengine';
 import { AlwaysAddressedMatcher, RegexAddressedMatcher, TURN_TAKING_TOOL_DEFINITIONS, } from '@memberjunction/ai-bridge-base';
 import { AIBridgeEngine, } from '@memberjunction/ai-bridge-server';
 import { LiveKitTokenService } from './livekit-token-service.js';
 import { ResolveLiveKitNativeModuleSpecifier } from './livekit-native-module.js';
+/**
+ * Static capability map for known realtime drivers when resolving full-duplex capability before session connect.
+ * Avoids class-name substring heuristics.
+ */
+const DRIVER_STATIC_CAPABILITIES = {
+    OpenAILiveRealtime: { FullDuplex: true },
+};
+function GetDriverStaticCapabilities(driverClass) {
+    if (!driverClass) {
+        return null;
+    }
+    const key = driverClass.trim().toLowerCase();
+    for (const [cls, caps] of Object.entries(DRIVER_STATIC_CAPABILITIES)) {
+        if (cls.toLowerCase() === key) {
+            return caps;
+        }
+    }
+    return null;
+}
 /** The `DriverClass` the LiveKit bridge registers under (must match the `MJ: AI Bridge Providers` row). */
 export const LIVEKIT_BRIDGE_DRIVER_CLASS = 'LiveKitBridge';
+/** The answer for a phone call: the module is not asked. */
+const PHONE_CALL_AVATAR_VIDEO = { Supported: false, Reason: 'phone' };
 /**
  * Coordinates starting (and stopping) an agent's presence in a LiveKit room. A process-wide singleton
  * (per MJ convention) so deployment code can bind the realtime-session factory once at startup and the
@@ -69,6 +95,24 @@ export class LiveKitAgentRoomCoordinator extends BaseSingleton {
     SetTurnToolBinder(binder) {
         this.turnToolBinder = binder;
     }
+    /**
+     * Binds the seam that says whether the agent behind a model session watches meetings. Without it no agent watches:
+     * the bot reads nobody's camera or screen and the room never offers people the choice.
+     *
+     * @param resolver The resolver, or `undefined` to clear it.
+     */
+    SetAgentVisionResolver(resolver) {
+        this.agentVisionResolver = resolver;
+    }
+    /**
+     * Binds the seam that records a failed start on the agent's co-agent run. Without it, the run of an agent whose start
+     * failed reads as completed: closing its model session finalizes the run that way.
+     *
+     * @param recorder The recorder, or `undefined` to clear it.
+     */
+    SetFailedStartRecorder(recorder) {
+        this.failedStartRecorder = recorder;
+    }
     /**
      * Overrides where a room's turn-taking snapshot comes from (an injectable seam for unit testing; production
      * reads the process-wide {@link AIBridgeEngine}).
@@ -106,12 +150,18 @@ export class LiveKitAgentRoomCoordinator extends BaseSingleton {
         this.bridgeOps = ops;
     }
     /**
-     * Starts the agent's presence in a LiveKit room: mints the bot token, opens the realtime session, and
-     * bridges it into the room.
+     * Starts the agent's presence in a LiveKit room: opens the realtime session, mints the bot token, and
+     * bridges the session into the room.
+     *
+     * A start that fails once the model session is open (the bot token can't be minted, the bridge doesn't start) closes
+     * that session before the error propagates, after recording the failure, with the start's error, on the session's
+     * co-agent run ({@link SetFailedStartRecorder}), which would otherwise read as completed. The agent session it runs under
+     * (`AgentSessionID`) is the caller's: a caller that created one for this start closes it.
      *
      * @param params The session parameters.
      * @returns The active session handles.
-     * @throws {Error} when the LiveKit provider is not configured/registered or the session factory is unbound.
+     * @throws {Error} when the LiveKit provider is not configured/registered, the session factory is unbound or fails,
+     *   the bot token can't be minted, or the bridge doesn't start.
      */
     async StartAgentRoomSession(params) {
         await this.bridgeOps.Config(false, params.ContextUser, params.MetadataProvider);
@@ -121,8 +171,11 @@ export class LiveKitAgentRoomCoordinator extends BaseSingleton {
                 'Seed/activate the LiveKit provider row before starting a room session.');
         }
         const botName = params.AgentName ?? 'Agent';
-        const botIdentity = `agent-${params.AgentSessionID}`;
-        const botToken = await this.tokenService.MintBotToken(params.RoomName, botIdentity, botName);
+        // `agent-<agent session id>`: the identity the bridge, the engine and other agents' bots read as an agent's.
+        const botIdentity = AgentParticipantIdentity(params.AgentSessionID);
+        // Fail before opening a model session when LiveKit isn't configured. The bot's token itself is minted once the
+        // session is open, because whether the bot watches depends on the session (see agentWatches).
+        this.tokenService.AssertConfigured();
         // Multi-agent MEETING detection: if the room already holds an agent, THIS agent joins as a meeting
         // participant — auto-response OFF, speaks only when addressed by name. When a room becomes multi-agent
         // the agents ALREADY in it are retroactively re-gated too (capability-permitting — see below). The names
@@ -137,17 +190,30 @@ export class LiveKitAgentRoomCoordinator extends BaseSingleton {
         // (gated meeting mode + LLM router) for controlled scenarios (webinars, large rooms, weaker models).
         const moderatorMode = process.env.MJ_REALTIME_MODERATOR_MODE === 'on';
         const isMeeting = moderatorMode && existingAgents.length > 0;
-        // A full-duplex model judges for itself whether it was addressed and uses the turn-taking tools; a gated
-        // meeting (moderator mode) decides addressing by name in the engine, so the tools would only confuse it.
         const addressing = isMeeting ? 'Regex' : params.TurnAddressing ?? 'Auto';
+        let resolvedFullDuplex = params.FullDuplex;
+        if (resolvedFullDuplex === undefined && params.RealtimeModelID) {
+            resolvedFullDuplex = this.resolveIsModelFullDuplexFromId(params.RealtimeModelID);
+        }
         const host = params.Host;
-        const turnTakingTools = addressing === 'Regex' ? [] : [...TURN_TAKING_TOOL_DEFINITIONS];
-        const combinedHostTools = (host?.HostTools?.length ?? 0) > 0 || turnTakingTools.length > 0
-            ? [...(host?.HostTools ?? []), ...turnTakingTools]
-            : undefined;
+        const buildToolsForFullDuplex = (isFd) => {
+            const turnTakingTools = isFd || addressing === 'Regex' ? [] : [...TURN_TAKING_TOOL_DEFINITIONS];
+            return (host?.HostTools?.length ?? 0) > 0 || turnTakingTools.length > 0
+                ? [...(host?.HostTools ?? []), ...turnTakingTools]
+                : undefined;
+        };
+        // Whether this host's bot can publish the agent's avatar is asked BEFORE the model session opens, so a host that
+        // can't never asks the model for it (and is never billed for video nobody sees). Cleared if the avatar is taken down.
+        // A phone call is never asked about: the caller sees no video, so the session asks for no avatar at all.
+        const phoneCall = host?.Channel === 'phone';
+        const avatarVideo = phoneCall ? PHONE_CALL_AVATAR_VIDEO : await this.DescribeAvatarVideo();
+        let avatarDelivery = avatarVideo.Supported === true ? 'room' : undefined;
         let activeTurnHandler = undefined;
         const openModelSession = async (priorTranscript) => {
+            const initialTools = buildToolsForFullDuplex(resolvedFullDuplex ?? false);
             const opened = await this.sessionFactory({
+                AvatarDelivery: avatarDelivery,
+                PhoneCall: phoneCall || undefined,
                 AgentID: params.AgentID,
                 AgentName: params.AgentName,
                 TargetAgentID: params.TargetAgentID,
@@ -160,72 +226,149 @@ export class LiveKitAgentRoomCoordinator extends BaseSingleton {
                 AgentSessionID: params.AgentSessionID,
                 MeetingMode: isMeeting || undefined,
                 SelfNames: isMeeting ? selfNames : undefined,
-                HostTools: combinedHostTools,
+                HostTools: initialTools,
                 HostFraming: host?.HostFraming,
                 ConversationID: host?.ConversationID,
                 PriorTranscript: priorTranscript,
+                ResolveHostTools: (resolved) => {
+                    if (resolvedFullDuplex === undefined) {
+                        if (resolved.ModelID) {
+                            const effective = AIEngine.Instance.GetEffectiveModelConfiguration(resolved.ModelID, resolved.ModelVendorID);
+                            const model = (AIEngine.Instance.Models ?? []).find(m => UUIDsEqual(m.ID, resolved.ModelID));
+                            const staticCaps = GetDriverStaticCapabilities(resolved.DriverClass);
+                            resolvedFullDuplex = ResolveIsModelFullDuplex(effective ?? model?.ModelConfigurationObject, staticCaps);
+                        }
+                        else if (resolved.DriverClass) {
+                            const staticCaps = GetDriverStaticCapabilities(resolved.DriverClass);
+                            resolvedFullDuplex = staticCaps?.FullDuplex === true;
+                        }
+                    }
+                    return buildToolsForFullDuplex(resolvedFullDuplex ?? false);
+                },
             });
+            const declaredTurnToolsInitially = !resolvedFullDuplex && addressing !== 'Regex';
+            if (resolvedFullDuplex === undefined) {
+                resolvedFullDuplex = opened.Capabilities?.FullDuplex === true;
+            }
+            else if (opened.Capabilities?.FullDuplex !== undefined && opened.Capabilities.FullDuplex !== resolvedFullDuplex) {
+                LogStatus(`[LiveKitAgentRoomCoordinator] WARNING: Session factory opened with Capabilities.FullDuplex=${opened.Capabilities.FullDuplex}, ` +
+                    `which disagrees with pre-open resolved FullDuplex=${resolvedFullDuplex}. Initial tools may mismatch.`);
+            }
+            // If full duplex is active, but turn-taking tools were declared to the session initially
+            // (e.g. because full-duplex was only discovered after open, or custom factory ignored ResolveHostTools):
+            if (resolvedFullDuplex && declaredTurnToolsInitially) {
+                const desiredTools = buildToolsForFullDuplex(true);
+                try {
+                    await opened.RegisterTools(desiredTools ?? []);
+                }
+                catch (err) {
+                    LogError(`[LiveKitAgentRoomCoordinator] Failed to reconfigure tools after discovering FullDuplex: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                // Explicitly bind a no-op handler so any in-flight or model-cached turn-taking tool calls return a clear "not available" result
+                if (this.turnToolBinder) {
+                    const noopTurnHandler = {
+                        Handles(toolName) {
+                            return TURN_TAKING_TOOL_DEFINITIONS.some(t => t.Name === toolName);
+                        },
+                        async Execute(call) {
+                            return JSON.stringify({
+                                success: false,
+                                error: `Tool '${call.ToolName}' is not available: session is running in full-duplex mode.`,
+                            });
+                        },
+                    };
+                    this.turnToolBinder(opened, noopTurnHandler);
+                }
+            }
             host?.OnModelSession?.(opened);
             if (activeTurnHandler) {
-                this.bindTurnTools(opened, activeTurnHandler, botName);
+                this.bindTurnTools(opened, activeTurnHandler, botName, resolvedFullDuplex);
             }
             return opened;
         };
         const session = await openModelSession();
+        const finalFullDuplex = resolvedFullDuplex ?? false;
         // The bridge id is known only after the engine starts the session, but the end-of-session hook is registered at start,
         // so it reaches the id through this holder.
         const started = {};
-        const active = await this.bridgeOps.StartBridgeSession({
-            AgentSessionID: params.AgentSessionID,
-            AgentID: params.AgentID,
-            Provider: provider,
-            RealtimeSession: session,
-            Address: botToken.ServerUrl,
-            JoinMethod: host?.JoinMethod ?? 'OnDemand',
-            Direction: host?.Direction,
-            TurnMode: params.TurnMode ?? 'Passive',
-            TurnAddressing: addressing,
-            // Meeting: gate speech to ADDRESSED turns (RegexAddressedMatcher on the agent's names) AND tell the
-            // engine the model's auto-response is off so the bridge becomes the sole trigger. Solo 1:1: respond to
-            // ALL the user's speech (AlwaysAddressedMatcher) with the model's own auto-response — Passive's
-            // name-match would otherwise leave a single agent silent unless you said its name each turn.
-            TurnMatcher: isMeeting ? new RegexAddressedMatcher(selfNames) : new AlwaysAddressedMatcher(),
-            DisableAutoResponse: isMeeting || undefined,
-            // Roster info for the room turn moderator (the LLM router, when one is wired via SetTurnModerator):
-            // the names it answers to + its participation style. `'proactive'` (default) lets the moderator bring
-            // it in unaddressed when relevant; per-agent `'addressed-only'` resolution from config is a follow-up.
-            AgentNames: selfNames,
-            ParticipationMode: 'proactive',
-            // The voiced TARGET agent (e.g. Sage) — the moderator resolves its role + per-agent turnTaking.mode.
-            TargetAgentID: params.TargetAgentID,
-            // NativeModuleSpecifier tells LiveKitNativeMeetingSdk which native room-client wrapper to load — the
-            // @livekit/rtc-node-backed @memberjunction/ai-bridge-livekit-native by default, overridable via env
-            // (e.g. a one-line module setting Gemini's 16 kHz inbound rate). AccessToken is the pre-signed bot
-            // join token; the room ws URL arrives as `Address`.
-            Configuration: {
-                AccessToken: botToken.Token,
-                BotDisplayName: botName,
-                RoomName: params.RoomName,
-                NativeModuleSpecifier: this.resolveNativeModuleSpecifier(),
-            },
-            ContextUser: params.ContextUser,
-            MetadataProvider: params.MetadataProvider,
-            // Host-owned call: its own transcript, barge-in policy, model recovery and end-of-session bookkeeping.
-            TranscriptSink: host?.TranscriptSink,
-            OnBargeIn: host?.OnBargeIn,
-            RecoverRealtimeSession: host?.RecoverModelSession ? (request) => openModelSession(request.PriorTranscript) : undefined,
-            OnSessionEnded: async (reason) => {
-                // An agent that leaves on its own (every human gone, the model lost, a handoff) must drop off the room's roster too.
-                if (started.SessionBridgeID) {
-                    this.removeFromRoster(started.SessionBridgeID);
-                }
-                await host?.OnSessionEnded?.(reason);
-            },
-        });
+        // Until the bridge engine holds the model session (StartBridgeSession resolves), the session is this start's to close:
+        // when the bot's token can't be minted or the bridge doesn't start, it is closed before the error propagates, so a
+        // failed start leaves no model connection open (#5308), and its co-agent run reads as failed, with the start's error.
+        // From then on the engine closes it when the bridge ends.
+        let botToken;
+        let active;
+        try {
+            const watches = this.agentWatches(session);
+            const avatar = this.avatarStatusFor(session, avatarVideo, botName);
+            const botAttributes = { ...(watches ? AgentWatchesAttributes(true) : {}), ...AgentAvatarAttributes(avatar) };
+            botToken = await this.mintBotToken(params.RoomName, botIdentity, botName, botAttributes);
+            active = await this.bridgeOps.StartBridgeSession({
+                AgentSessionID: params.AgentSessionID,
+                AgentID: params.AgentID,
+                Provider: provider,
+                RealtimeSession: session,
+                FullDuplex: finalFullDuplex,
+                Address: botToken.ServerUrl,
+                JoinMethod: host?.JoinMethod ?? 'OnDemand',
+                Direction: host?.Direction,
+                TurnMode: params.TurnMode ?? 'Passive',
+                TurnAddressing: addressing,
+                // Meeting: gate speech to ADDRESSED turns (RegexAddressedMatcher on the agent's names) AND tell the
+                // engine the model's auto-response is off so the bridge becomes the sole trigger. Solo 1:1: respond to
+                // ALL the user's speech (AlwaysAddressedMatcher) with the model's own auto-response — Passive's
+                // name-match would otherwise leave a single agent silent unless you said its name each turn.
+                TurnMatcher: isMeeting ? new RegexAddressedMatcher(selfNames) : new AlwaysAddressedMatcher(),
+                DisableAutoResponse: isMeeting || undefined,
+                // Roster info for the room turn moderator (the LLM router, when one is wired via SetTurnModerator):
+                // the names it answers to + its participation style. `'proactive'` (default) lets the moderator bring
+                // it in unaddressed when relevant; per-agent `'addressed-only'` resolution from config is a follow-up.
+                AgentNames: selfNames,
+                ParticipationMode: 'proactive',
+                // The voiced TARGET agent (e.g. Sage) — the moderator resolves its role + per-agent turnTaking.mode.
+                TargetAgentID: params.TargetAgentID,
+                // NativeModuleSpecifier tells LiveKitNativeMeetingSdk which native room-client wrapper to load — the
+                // @livekit/rtc-node-backed @memberjunction/ai-bridge-livekit-native by default, overridable via env
+                // (e.g. a one-line module setting Gemini's 16 kHz inbound rate). AccessToken is the pre-signed bot
+                // join token; the room ws URL arrives as `Address`.
+                Configuration: {
+                    AccessToken: botToken.Token,
+                    BotDisplayName: botName,
+                    RoomName: params.RoomName,
+                    NativeModuleSpecifier: this.resolveNativeModuleSpecifier(),
+                    // The bot reads the cameras and screens of people who allow it, only when this agent watches.
+                    AgentVision: watches,
+                },
+                ContextUser: params.ContextUser,
+                MetadataProvider: params.MetadataProvider,
+                // Host-owned call: its own transcript, barge-in policy, model recovery and end-of-session bookkeeping.
+                TranscriptSink: host?.TranscriptSink,
+                OnBargeIn: host?.OnBargeIn,
+                RecoverRealtimeSession: host?.RecoverModelSession ? (request) => openModelSession(request.PriorTranscript) : undefined,
+                // The bot took the avatar down mid-meeting: the model session is replaced by one that renders none (and re-opened
+                // without it from then on), so the model stops generating video nobody sees.
+                RecoverRealtimeSessionWithoutAvatar: avatar?.Granted
+                    ? (request) => {
+                        avatarDelivery = undefined;
+                        return openModelSession(request.PriorTranscript);
+                    }
+                    : undefined,
+                OnSessionEnded: async (reason) => {
+                    // An agent that leaves on its own (every human gone, the model lost, a handoff) must drop off the room's roster too.
+                    if (started.SessionBridgeID) {
+                        this.removeFromRoster(started.SessionBridgeID);
+                    }
+                    await host?.OnSessionEnded?.(reason);
+                },
+            });
+        }
+        catch (err) {
+            await this.closeModelSessionOfFailedStart(session, err);
+            throw err;
+        }
         started.SessionBridgeID = active.SessionBridgeID;
         this.addToRoster(roomKey, { AgentSessionID: params.AgentSessionID, SessionBridgeID: active.SessionBridgeID, Names: selfNames });
         activeTurnHandler = active.TurnTakingToolHandler;
-        this.bindTurnTools(session, active.TurnTakingToolHandler, botName);
+        this.bindTurnTools(session, active.TurnTakingToolHandler, botName, finalFullDuplex);
         // The room just became (or stayed) multi-agent → retroactively re-gate the agents already in it into
         // meeting mode so the whole room takes turns, not just the newcomers. Capability-gated in the engine:
         // a provider that can't reconfigure a live session (e.g. Gemini) is left conversational, no dead call.
@@ -239,18 +382,119 @@ export class LiveKitAgentRoomCoordinator extends BaseSingleton {
             `(bridge ${active.SessionBridgeID}, ${isMeeting ? 'MEETING — addressed-only' : 'solo 1:1'})`);
         return { SessionBridgeID: active.SessionBridgeID, RoomName: params.RoomName, ServerUrl: botToken.ServerUrl };
     }
-    /** Installs the engine's turn-taking tool handler on the model session, when the session has one (a full-duplex model in a room). */
-    bindTurnTools(session, handler, botName) {
+    /**
+     * Whether the agent behind this model session watches the meeting: its setting is on (through the bound
+     * {@link AgentVisionResolver}) AND its session takes inbound video. Watching on an audio-only model would offer people
+     * a choice no frame could honour, so it is logged and treated as off.
+     */
+    agentWatches(session) {
+        const settingOn = this.agentVisionResolver?.(session) === true;
+        if (settingOn && InboundVideoStreamsOf(session.Capabilities) === 0) {
+            LogStatus('[LiveKitAgentRoomCoordinator] The agent is set to watch meetings, but its realtime model takes no video; it will not watch.');
+            return false;
+        }
+        return settingOn;
+    }
+    /**
+     * Whether this host's bots can publish an agent's avatar, from the native room module the bots join with (`ffmpeg`
+     * with the H.264 and AAC decoders, and a room SDK that publishes video). Asked before every agent's model session
+     * opens; the module probes once and remembers. A module that cannot be loaded, or that predates avatars, means no.
+     */
+    async DescribeAvatarVideo() {
+        try {
+            const nativeModule = await DefaultNativeLoader(this.resolveNativeModuleSpecifier());
+            if (!nativeModule.describeAvatarVideo) {
+                return { Supported: false, Reason: 'bridged', Detail: 'the native room module publishes no avatars' };
+            }
+            return await nativeModule.describeAvatarVideo();
+        }
+        catch (err) {
+            return { Supported: false, Reason: 'bridged', Detail: `the native room module could not be asked: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+    /**
+     * What became of the agent's avatar request: the session's own status, except that a session which asked for an
+     * avatar and stayed audio only because this host could not publish it carries the host's reason (`decoder-missing`
+     * when there is no usable ffmpeg, `phone` on a phone call whose session factory still asked). Logged once per join when
+     * an avatar was asked for.
+     */
+    avatarStatusFor(session, avatarVideo, botName) {
+        const status = session.AvatarStatus;
+        if (!status?.Requested) {
+            return status;
+        }
+        const resolved = !status.Granted && status.Reason === 'bridged' && avatarVideo.Supported === false ? { ...status, Reason: avatarVideo.Reason } : status;
+        const detail = avatarVideo.Supported === false && avatarVideo.Detail ? ` (${avatarVideo.Detail})` : '';
+        LogStatus(`[LiveKitAgentRoomCoordinator] ${botName}'s avatar: ${resolved.Granted ? 'on' : `audio only, ${resolved.Reason ?? 'bridged'}${detail}`}`);
+        return resolved;
+    }
+    /**
+     * Mints the bot's join token with its attributes: `mj.agentWatches` when the agent watches, so the room offers people
+     * the choice from the moment the bot joins, and `mj.agentAvatar` when the agent asked for an avatar. Minted once the
+     * model session is open; when it fails, the start closes that session (see {@link StartAgentRoomSession}).
+     */
+    async mintBotToken(roomName, botIdentity, botName, attributes) {
+        return this.tokenService.MintBotToken(roomName, botIdentity, botName, Object.keys(attributes).length > 0 ? attributes : undefined);
+    }
+    /**
+     * Closes the model session of a start that failed before the bridge engine took it: the bot's token could not be minted,
+     * or the bridge did not start (its row could not be saved, the driver could not connect). The failure is recorded on the
+     * session's co-agent run first ({@link FailedStartRecorder}), since the close alone would finalize that run as completed.
+     * Neither step throws: a failure is logged, so the caller sees why the start failed and the session is still closed.
+     */
+    async closeModelSessionOfFailedStart(session, startError) {
+        try {
+            await this.failedStartRecorder?.(session, startError instanceof Error ? startError.message : String(startError));
+        }
+        catch (err) {
+            LogError(`[LiveKitAgentRoomCoordinator] recording a failed start on the agent's run failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        try {
+            await session.Close();
+        }
+        catch (err) {
+            LogError(`[LiveKitAgentRoomCoordinator] closing the model session of a failed start failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** Installs the engine's turn-taking tool handler on the model session, when the session has one (a turn-based model in a room). */
+    bindTurnTools(session, handler, botName, isFullDuplex) {
         if (!handler) {
             return;
         }
+        // Full-duplex models never get turn-taking tools; do not bind turn-taking handlers to them
+        if (isFullDuplex) {
+            return;
+        }
         if (!this.turnToolBinder) {
-            LogError(`[LiveKitAgentRoomCoordinator] ${botName} is full-duplex but no turn-tool binder is set (SetTurnToolBinder); ` +
-                'its i_am_addressed / yield_turn calls will not execute. The room floor gate still prevents overlap.');
+            LogError(`[LiveKitAgentRoomCoordinator] ${botName} has turn-taking tools but no turn-tool binder is set (SetTurnToolBinder); ` +
+                'its i_am_addressed / yield_turn calls will not execute.');
             return;
         }
         this.turnToolBinder(session, handler);
     }
+    /**
+     * Resolves whether the model with the given ID is full duplex from model metadata and static driver capabilities.
+     */
+    resolveIsModelFullDuplexFromId(modelId) {
+        try {
+            const model = (AIEngine.Instance.Models ?? []).find(m => UUIDsEqual(m.ID, modelId));
+            if (!model) {
+                return undefined;
+            }
+            const vendors = (AIEngine.Instance.ModelVendorsByModelID?.get(NormalizeUUID(model.ID)) ??
+                (AIEngine.Instance.ModelVendors ?? []).filter(mv => UUIDsEqual(mv.ModelID, model.ID)))
+                .filter(v => v.DriverClass != null && (v.Status === undefined || v.Status === 'Active'))
+                .sort((a, b) => (b.Priority ?? 0) - (a.Priority ?? 0));
+            const primaryVendor = vendors[0];
+            const effective = AIEngine.Instance.GetEffectiveModelConfiguration(model.ID, primaryVendor?.ID);
+            const staticCaps = GetDriverStaticCapabilities(primaryVendor?.DriverClass);
+            return ResolveIsModelFullDuplex(effective ?? model.ModelConfigurationObject, staticCaps);
+        }
+        catch (err) {
+            LogError(`[LiveKitAgentRoomCoordinator] resolveIsModelFullDuplexFromId failed: ${err instanceof Error ? err.message : String(err)}`);
+            return undefined;
+        }
+    }
     /** Appends an agent to a room's roster (creating the room's list on first join). */
     addToRoster(roomKey, entry) {
         const roster = this.roomRosters.get(roomKey);

package/dist/livekit-agent-room-coordinator.js.map

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

package/dist/livekit-native-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"livekit-native-module.d.ts","sourceRoot":"","sources":["../src/livekit-native-module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uGAAuG;AACvG,eAAO,MAAM,6BAA6B,6CAA6C,CAAC;AAExF;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7E"}
+{"version":3,"file":"livekit-native-module.d.ts","sourceRoot":"","sources":["../src/livekit-native-module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,uGAAuG;AACvG,eAAO,MAAM,6BAA6B,6CAA6C,CAAC;AAExF;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7E"}

package/dist/livekit-native-module.js

@@ -5,6 +5,8 @@
  *
  * @module @memberjunction/livekit-room-server
  */
+import { RegisterNativeRoomModule } from '@memberjunction/ai-bridge-livekit';
+import NativeRoomModuleDefault from '@memberjunction/ai-bridge-livekit-native';
 /** The default native room-client wrapper — the `@livekit/rtc-node`-backed package this repo ships. */
 export const DEFAULT_LIVEKIT_NATIVE_MODULE = '@memberjunction/ai-bridge-livekit-native';
 /**
@@ -17,4 +19,9 @@ export const DEFAULT_LIVEKIT_NATIVE_MODULE = '@memberjunction/ai-bridge-livekit-
 export function ResolveLiveKitNativeModuleSpecifier(override) {
     return override ?? process.env.LIVEKIT_NATIVE_MODULE ?? DEFAULT_LIVEKIT_NATIVE_MODULE;
 }
+// The bridge package's loader cannot `import()` the default wrapper itself: it does not (and, to avoid a dependency
+// cycle, must not) declare it, so the bare specifier does not resolve from there under pnpm's strict layout. This
+// package declares the wrapper, so it imports it statically and registers it for the loader to find. An override
+// specifier (`LIVEKIT_NATIVE_MODULE`) that is not registered still goes through the loader's `import()`.
+RegisterNativeRoomModule(DEFAULT_LIVEKIT_NATIVE_MODULE, NativeRoomModuleDefault);
 //# sourceMappingURL=livekit-native-module.js.map

package/dist/livekit-native-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"livekit-native-module.js","sourceRoot":"","sources":["../src/livekit-native-module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uGAAuG;AACvG,MAAM,CAAC,MAAM,6BAA6B,GAAG,0CAA0C,CAAC;AAExF;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CAAC,QAAiB;IACnE,OAAO,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,6BAA6B,CAAC;AACxF,CAAC"}
+{"version":3,"file":"livekit-native-module.js","sourceRoot":"","sources":["../src/livekit-native-module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,uBAAuB,MAAM,0CAA0C,CAAC;AAE/E,uGAAuG;AACvG,MAAM,CAAC,MAAM,6BAA6B,GAAG,0CAA0C,CAAC;AAExF;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CAAC,QAAiB;IACnE,OAAO,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,6BAA6B,CAAC;AACxF,CAAC;AAED,oHAAoH;AACpH,kHAAkH;AAClH,iHAAiH;AACjH,yGAAyG;AACzG,wBAAwB,CAAC,6BAA6B,EAAE,uBAAuB,CAAC,CAAC"}

package/dist/livekit-participant-service.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview {@link LiveKitParticipantService} — changes a participant in a live room through LiveKit's
+ * `RoomServiceClient` (`livekit-server-sdk`). Today it records whether a person lets agents see their camera and shared
+ * screen. A participant's token can't change its own attributes: MJ's tokens carry no `canUpdateOwnMetadata`, because
+ * the same right would let anyone rename themselves and rewrite the metadata that carries their role. So the server
+ * sets the attribute for them, once MJAPI has worked out who is asking.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { RoomServiceClient } from 'livekit-server-sdk';
+import { type LiveKitServerConfig } from './livekit-token-service.js';
+/** The subset of {@link RoomServiceClient} the service drives — an injectable seam for unit testing. */
+export type ParticipantUpdateClientLike = Pick<RoomServiceClient, 'updateParticipant'>;
+/** The outcome of changing a participant. */
+export interface ParticipantUpdateResult {
+    /** Whether LiveKit applied the change. */
+    Success: boolean;
+    /** `true` when LiveKit refused because that participant (or the room) does not exist. */
+    NotInRoom?: boolean;
+    /** What went wrong, when it failed. */
+    ErrorMessage?: string;
+}
+/** Changes participants in live LiveKit rooms, on the server's authority. */
+export declare class LiveKitParticipantService {
+    private readonly configured;
+    private readonly client;
+    /**
+     * @param config Explicit credentials; omitted fields fall back to environment variables (via
+     *   {@link LiveKitTokenService}). The room service client uses the HTTP(S) form of the server URL.
+     * @param client An injectable room service client (primarily for unit testing); defaults to a real
+     *   `RoomServiceClient` built from the resolved credentials.
+     */
+    constructor(config?: Partial<LiveKitServerConfig>, client?: ParticipantUpdateClientLike);
+    /**
+     * Records whether a person lets agents see their camera and shared screen: sets their `mj.agentCanSee` attribute to
+     * `'true'`, or removes it. The caller must already have established that `identity` is the person asking.
+     *
+     * @param roomName The room the person is in.
+     * @param identity The person's participant identity.
+     * @param allow `true` to let agents see, `false` to stop.
+     * @returns Whether LiveKit applied it; never throws.
+     */
+    SetAgentVision(roomName: string, identity: string, allow: boolean): Promise<ParticipantUpdateResult>;
+    /** Sets (or, with `''`, removes) a participant's attributes; reports LiveKit's refusal instead of throwing. */
+    private updateAttributes;
+}
+//# sourceMappingURL=livekit-participant-service.d.ts.map

package/dist/livekit-participant-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekit-participant-service.d.ts","sourceRoot":"","sources":["../src/livekit-participant-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAc,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGxF,wGAAwG;AACxG,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;AAEvF,6CAA6C;AAC7C,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,yFAAyF;IACzF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,6EAA6E;AAC7E,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IAErD;;;;;OAKG;gBACS,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,EAAE,2BAA2B;IAOvF;;;;;;;;OAQG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIjH,+GAA+G;YACjG,gBAAgB;CAc/B"}