@memberjunction/ai-agents 5.40.1 → 5.41.0

package/dist/realtime/meeting-controls-state.d.ts

@@ -0,0 +1,191 @@
+/**
+ * @fileoverview Pure, platform-free state machine for the Meeting Controls channel — the
+ * facilitator intel an agent acts on: the ordered hand-raise QUEUE, who is speaking, the roster,
+ * and a meeting/agenda timer. Deliberately free of any realtime/bridge/MJ dependency so it is
+ * exhaustively unit-testable with an injected clock and no platform.
+ *
+ * The {@link import('./meeting-controls-channel-server.js').MeetingControlsChannelServer} owns one of
+ * these per session, mutates it from the injected bridge event stream + the agent's tool calls, and
+ * serializes {@link MeetingControlsState.BuildPerception} snapshots back to the model.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+/**
+ * The role a participant plays in the meeting, from the facilitator's point of view. A union (not an
+ * enum) so it exports cleanly and stays additive. `Agent` is the facilitating bot itself.
+ */
+export type MeetingParticipantRole = 'Host' | 'CoHost' | 'Participant' | 'Agent';
+/**
+ * One participant on the meeting roster, as the Meeting Controls channel tracks them. Minimal and
+ * platform-agnostic — a bridge driver maps its native roster (`BridgeParticipantInfo`, a Zoom
+ * participant, a Twilio call leg, …) onto this shape when feeding the channel's event source.
+ */
+export interface MeetingParticipant {
+    /** Stable platform-native participant id (the key the queue / speaking / mute state is keyed on). */
+    ParticipantId: string;
+    /** Human-readable display name, when the platform reports one. */
+    DisplayName?: string;
+    /** The participant's role in the meeting. */
+    Role: MeetingParticipantRole;
+    /** Whether this participant is an agent bot (the facilitator excludes agents from hand-raise / call-on). */
+    IsAgent: boolean;
+}
+/**
+ * One entry in the hand-raise queue: who raised, and WHEN (so the queue preserves raise order and the
+ * perception feed can report how long each person has been waiting).
+ */
+export interface HandRaiseQueueEntry {
+    /** The participant who raised their hand. */
+    ParticipantId: string;
+    /** Their display name at raise time (for a human-readable queue in the perception feed). */
+    DisplayName?: string;
+    /** Epoch-ms when the hand was raised — drives queue ordering and wait-time reporting. */
+    RaisedAtMs: number;
+}
+/**
+ * A monotonic clock, injected so the queue/timer logic is deterministic in tests. Defaults to
+ * `Date.now` in production.
+ */
+export type MeetingControlsClock = () => number;
+/**
+ * A snapshot of the timer the agent set (via the `SetTimer` tool), reported in the perception feed so
+ * the agent can pace the meeting ("two minutes left on this agenda item").
+ */
+export interface MeetingTimerSnapshot {
+    /** The total duration the timer was set for, in seconds. */
+    DurationSeconds: number;
+    /** Whole seconds elapsed since the timer was set (clamped to `[0, DurationSeconds]`). */
+    ElapsedSeconds: number;
+    /** Whole seconds remaining (clamped to `[0, DurationSeconds]`); `0` once the timer has expired. */
+    RemainingSeconds: number;
+    /** Whether the timer has reached or passed its duration. */
+    Expired: boolean;
+}
+/**
+ * The full perception payload the channel serializes back to the model — the facilitator's situational
+ * awareness in one object: the roster, the ordered hand-raise queue, who is speaking, and the timer.
+ */
+export interface MeetingControlsPerception {
+    /** The current roster (every known participant, agents included). */
+    Roster: MeetingParticipant[];
+    /** The hand-raise queue in RAISE ORDER (oldest first) — who is waiting and for how long. */
+    HandRaiseQueue: Array<HandRaiseQueueEntry & {
+        WaitingSeconds: number;
+    }>;
+    /** The participant ids currently speaking (diarized), in no particular order. */
+    SpeakingParticipantIds: string[];
+    /** The participant ids the agent has muted via the channel (best-effort mirror of mute state). */
+    MutedParticipantIds: string[];
+    /** The active agenda/meeting timer, or `null` when none is set. */
+    Timer: MeetingTimerSnapshot | null;
+}
+/**
+ * Pure facilitator state — the ordered hand-raise queue, who is speaking, the roster, mute state, and
+ * a single agenda timer. No I/O, no realtime/bridge coupling; mutated by the channel server from the
+ * bridge event stream and the agent's tool calls, then snapshotted via {@link BuildPerception}.
+ *
+ * All time-based behavior reads the injected {@link MeetingControlsClock}, so a test can advance time
+ * deterministically and assert exact wait / elapsed / remaining values.
+ */
+export declare class MeetingControlsState {
+    /** Roster keyed by participant id (insertion order preserved for stable perception output). */
+    private roster;
+    /** Hand-raise queue in raise order (oldest first). A participant appears at most once. */
+    private handQueue;
+    /** Currently-speaking participant ids (diarized). */
+    private speaking;
+    /** Participant ids the agent muted via the channel. */
+    private muted;
+    /** The active timer's total duration (seconds) and start time (epoch-ms), or `null` when unset. */
+    private timer;
+    /** Injected clock for deterministic time math. */
+    private readonly clock;
+    /**
+     * @param clock The monotonic clock to read for queue wait-times and the timer. Defaults to `Date.now`.
+     */
+    constructor(clock?: MeetingControlsClock);
+    /**
+     * Replaces the roster wholesale with a fresh snapshot from the bridge. Participants who left the
+     * meeting (no longer in the snapshot) are pruned from the queue, the speaking set, and the mute
+     * set so stale ids never linger in the perception feed.
+     *
+     * @param participants The current roster snapshot.
+     */
+    SetRoster(participants: MeetingParticipant[]): void;
+    /** The current roster (every known participant), in insertion order. */
+    GetRoster(): MeetingParticipant[];
+    /** Looks up a participant by id, or `undefined` when not on the roster. */
+    GetParticipant(participantId: string): MeetingParticipant | undefined;
+    /**
+     * Adds a participant to the hand-raise queue (idempotent — a second raise by someone already in
+     * the queue keeps their ORIGINAL position and raise time, never jumping them forward). A raise by
+     * someone not on the roster is ignored (the bridge should roster them first).
+     *
+     * @param participantId The participant raising their hand.
+     * @returns `true` when the queue changed (a new raise landed), `false` otherwise.
+     */
+    RaiseHand(participantId: string): boolean;
+    /**
+     * Removes a participant from the hand-raise queue (the explicit `LowerHand` tool, and the
+     * implicit lower when they are called on). Preserves the order of everyone else.
+     *
+     * @param participantId The participant whose hand to lower.
+     * @returns `true` when they were in the queue and were removed, `false` otherwise.
+     */
+    LowerHand(participantId: string): boolean;
+    /** Whether a participant is currently in the hand-raise queue. */
+    isQueued(participantId: string): boolean;
+    /** The next participant in the queue (front of the line), or `undefined` when the queue is empty. */
+    PeekNextHand(): HandRaiseQueueEntry | undefined;
+    /**
+     * "Calls on" a participant: removes them from the hand-raise queue (lowering their hand) and
+     * returns them. When `participantId` is omitted, calls on the FRONT of the queue (next in line).
+     * Returns `undefined` when there is no one to call on (empty queue, or the named id isn't queued).
+     *
+     * @param participantId Optional specific participant to call on; defaults to the queue front.
+     * @returns The participant called on, or `undefined`.
+     */
+    CallOn(participantId?: string): HandRaiseQueueEntry | undefined;
+    /** The hand-raise queue in raise order (oldest first), each stamped with current wait seconds. */
+    GetHandRaiseQueue(): Array<HandRaiseQueueEntry & {
+        WaitingSeconds: number;
+    }>;
+    /**
+     * Replaces the set of currently-speaking participants (from the bridge's diarization stream).
+     *
+     * @param participantIds The ids now speaking.
+     */
+    SetSpeaking(participantIds: string[]): void;
+    /** The participant ids currently speaking. */
+    GetSpeaking(): string[];
+    /**
+     * Marks a participant muted by the channel (the agent's `MuteParticipant` tool). The actual
+     * platform mute is the driver's job; this mirrors the intent so the perception feed reflects it.
+     *
+     * @param participantId The participant to mark muted.
+     * @returns `true` when the participant is on the roster (and was marked), `false` otherwise.
+     */
+    MarkMuted(participantId: string): boolean;
+    /** The participant ids the agent has muted via the channel. */
+    GetMuted(): string[];
+    /**
+     * Sets (or resets) the agenda timer to `durationSeconds`, starting now. A non-positive duration
+     * clears the timer. Setting a new timer replaces any existing one.
+     *
+     * @param durationSeconds The timer duration in seconds; `<= 0` clears it.
+     */
+    SetTimer(durationSeconds: number): void;
+    /** Clears the agenda timer. */
+    ClearTimer(): void;
+    /** The current timer snapshot (elapsed / remaining / expired), or `null` when none is set. */
+    GetTimer(): MeetingTimerSnapshot | null;
+    /**
+     * Builds the full perception snapshot the channel serializes back to the model — the facilitator's
+     * complete situational awareness in one object.
+     *
+     * @returns The perception payload.
+     */
+    BuildPerception(): MeetingControlsPerception;
+}
+//# sourceMappingURL=meeting-controls-state.d.ts.map

package/dist/realtime/meeting-controls-state.d.ts.map

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

package/dist/realtime/meeting-controls-state.js

@@ -0,0 +1,219 @@
+/**
+ * @fileoverview Pure, platform-free state machine for the Meeting Controls channel — the
+ * facilitator intel an agent acts on: the ordered hand-raise QUEUE, who is speaking, the roster,
+ * and a meeting/agenda timer. Deliberately free of any realtime/bridge/MJ dependency so it is
+ * exhaustively unit-testable with an injected clock and no platform.
+ *
+ * The {@link import('./meeting-controls-channel-server.js').MeetingControlsChannelServer} owns one of
+ * these per session, mutates it from the injected bridge event stream + the agent's tool calls, and
+ * serializes {@link MeetingControlsState.BuildPerception} snapshots back to the model.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+/**
+ * Pure facilitator state — the ordered hand-raise queue, who is speaking, the roster, mute state, and
+ * a single agenda timer. No I/O, no realtime/bridge coupling; mutated by the channel server from the
+ * bridge event stream and the agent's tool calls, then snapshotted via {@link BuildPerception}.
+ *
+ * All time-based behavior reads the injected {@link MeetingControlsClock}, so a test can advance time
+ * deterministically and assert exact wait / elapsed / remaining values.
+ */
+export class MeetingControlsState {
+    /**
+     * @param clock The monotonic clock to read for queue wait-times and the timer. Defaults to `Date.now`.
+     */
+    constructor(clock = () => Date.now()) {
+        /** Roster keyed by participant id (insertion order preserved for stable perception output). */
+        this.roster = new Map();
+        /** Hand-raise queue in raise order (oldest first). A participant appears at most once. */
+        this.handQueue = [];
+        /** Currently-speaking participant ids (diarized). */
+        this.speaking = new Set();
+        /** Participant ids the agent muted via the channel. */
+        this.muted = new Set();
+        /** The active timer's total duration (seconds) and start time (epoch-ms), or `null` when unset. */
+        this.timer = null;
+        this.clock = clock;
+    }
+    // ── Roster ────────────────────────────────────────────────────────────────────
+    /**
+     * Replaces the roster wholesale with a fresh snapshot from the bridge. Participants who left the
+     * meeting (no longer in the snapshot) are pruned from the queue, the speaking set, and the mute
+     * set so stale ids never linger in the perception feed.
+     *
+     * @param participants The current roster snapshot.
+     */
+    SetRoster(participants) {
+        this.roster = new Map(participants.map((p) => [p.ParticipantId, p]));
+        const present = new Set(participants.map((p) => p.ParticipantId));
+        this.handQueue = this.handQueue.filter((e) => present.has(e.ParticipantId));
+        for (const id of [...this.speaking]) {
+            if (!present.has(id)) {
+                this.speaking.delete(id);
+            }
+        }
+        for (const id of [...this.muted]) {
+            if (!present.has(id)) {
+                this.muted.delete(id);
+            }
+        }
+    }
+    /** The current roster (every known participant), in insertion order. */
+    GetRoster() {
+        return [...this.roster.values()];
+    }
+    /** Looks up a participant by id, or `undefined` when not on the roster. */
+    GetParticipant(participantId) {
+        return this.roster.get(participantId);
+    }
+    // ── Hand-raise queue ───────────────────────────────────────────────────────────
+    /**
+     * Adds a participant to the hand-raise queue (idempotent — a second raise by someone already in
+     * the queue keeps their ORIGINAL position and raise time, never jumping them forward). A raise by
+     * someone not on the roster is ignored (the bridge should roster them first).
+     *
+     * @param participantId The participant raising their hand.
+     * @returns `true` when the queue changed (a new raise landed), `false` otherwise.
+     */
+    RaiseHand(participantId) {
+        if (!this.roster.has(participantId) || this.isQueued(participantId)) {
+            return false;
+        }
+        const participant = this.roster.get(participantId);
+        this.handQueue.push({
+            ParticipantId: participantId,
+            DisplayName: participant?.DisplayName,
+            RaisedAtMs: this.clock(),
+        });
+        return true;
+    }
+    /**
+     * Removes a participant from the hand-raise queue (the explicit `LowerHand` tool, and the
+     * implicit lower when they are called on). Preserves the order of everyone else.
+     *
+     * @param participantId The participant whose hand to lower.
+     * @returns `true` when they were in the queue and were removed, `false` otherwise.
+     */
+    LowerHand(participantId) {
+        const before = this.handQueue.length;
+        this.handQueue = this.handQueue.filter((e) => e.ParticipantId !== participantId);
+        return this.handQueue.length !== before;
+    }
+    /** Whether a participant is currently in the hand-raise queue. */
+    isQueued(participantId) {
+        return this.handQueue.some((e) => e.ParticipantId === participantId);
+    }
+    /** The next participant in the queue (front of the line), or `undefined` when the queue is empty. */
+    PeekNextHand() {
+        return this.handQueue[0];
+    }
+    /**
+     * "Calls on" a participant: removes them from the hand-raise queue (lowering their hand) and
+     * returns them. When `participantId` is omitted, calls on the FRONT of the queue (next in line).
+     * Returns `undefined` when there is no one to call on (empty queue, or the named id isn't queued).
+     *
+     * @param participantId Optional specific participant to call on; defaults to the queue front.
+     * @returns The participant called on, or `undefined`.
+     */
+    CallOn(participantId) {
+        const target = participantId
+            ? this.handQueue.find((e) => e.ParticipantId === participantId)
+            : this.handQueue[0];
+        if (!target) {
+            return undefined;
+        }
+        this.LowerHand(target.ParticipantId);
+        return target;
+    }
+    /** The hand-raise queue in raise order (oldest first), each stamped with current wait seconds. */
+    GetHandRaiseQueue() {
+        const now = this.clock();
+        return this.handQueue.map((e) => ({
+            ...e,
+            WaitingSeconds: Math.max(0, Math.floor((now - e.RaisedAtMs) / 1000)),
+        }));
+    }
+    // ── Speaking ──────────────────────────────────────────────────────────────────
+    /**
+     * Replaces the set of currently-speaking participants (from the bridge's diarization stream).
+     *
+     * @param participantIds The ids now speaking.
+     */
+    SetSpeaking(participantIds) {
+        this.speaking = new Set(participantIds);
+    }
+    /** The participant ids currently speaking. */
+    GetSpeaking() {
+        return [...this.speaking];
+    }
+    // ── Mute ──────────────────────────────────────────────────────────────────────
+    /**
+     * Marks a participant muted by the channel (the agent's `MuteParticipant` tool). The actual
+     * platform mute is the driver's job; this mirrors the intent so the perception feed reflects it.
+     *
+     * @param participantId The participant to mark muted.
+     * @returns `true` when the participant is on the roster (and was marked), `false` otherwise.
+     */
+    MarkMuted(participantId) {
+        if (!this.roster.has(participantId)) {
+            return false;
+        }
+        this.muted.add(participantId);
+        return true;
+    }
+    /** The participant ids the agent has muted via the channel. */
+    GetMuted() {
+        return [...this.muted];
+    }
+    // ── Timer ─────────────────────────────────────────────────────────────────────
+    /**
+     * Sets (or resets) the agenda timer to `durationSeconds`, starting now. A non-positive duration
+     * clears the timer. Setting a new timer replaces any existing one.
+     *
+     * @param durationSeconds The timer duration in seconds; `<= 0` clears it.
+     */
+    SetTimer(durationSeconds) {
+        if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) {
+            this.timer = null;
+            return;
+        }
+        this.timer = { durationSeconds: Math.floor(durationSeconds), startedAtMs: this.clock() };
+    }
+    /** Clears the agenda timer. */
+    ClearTimer() {
+        this.timer = null;
+    }
+    /** The current timer snapshot (elapsed / remaining / expired), or `null` when none is set. */
+    GetTimer() {
+        if (!this.timer) {
+            return null;
+        }
+        const elapsedRaw = Math.floor((this.clock() - this.timer.startedAtMs) / 1000);
+        const elapsed = Math.min(this.timer.durationSeconds, Math.max(0, elapsedRaw));
+        const remaining = Math.max(0, this.timer.durationSeconds - elapsed);
+        return {
+            DurationSeconds: this.timer.durationSeconds,
+            ElapsedSeconds: elapsed,
+            RemainingSeconds: remaining,
+            Expired: remaining === 0,
+        };
+    }
+    // ── Perception ────────────────────────────────────────────────────────────────
+    /**
+     * Builds the full perception snapshot the channel serializes back to the model — the facilitator's
+     * complete situational awareness in one object.
+     *
+     * @returns The perception payload.
+     */
+    BuildPerception() {
+        return {
+            Roster: this.GetRoster(),
+            HandRaiseQueue: this.GetHandRaiseQueue(),
+            SpeakingParticipantIds: this.GetSpeaking(),
+            MutedParticipantIds: this.GetMuted(),
+            Timer: this.GetTimer(),
+        };
+    }
+}
+//# sourceMappingURL=meeting-controls-state.js.map

package/dist/realtime/meeting-controls-state.js.map

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

package/dist/realtime/realtime-channel-server-host.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @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, RealtimeChannelServerContext, RealtimeChannelCloseReason, RealtimeToolDefinition, ServerChannelToolResult } from '@memberjunction/ai';
+import { BaseSingleton } from '@memberjunction/global';
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+/**
+ * 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 declare class RealtimeChannelServerHost extends BaseSingleton<RealtimeChannelServerHost> {
+    /** session id (lowercased) → that session's plugin instances + disposal state. */
+    private sessions;
+    /**
+     * 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.
+     */
+    DisposeLingerMs: number;
+    protected constructor();
+    /** Process-wide singleton accessor (Global Object Store backed via {@link BaseSingleton}). */
+    static get Instance(): RealtimeChannelServerHost;
+    /** Number of sessions currently holding live (or close-lingering) plugin instances. */
+    get ActiveSessionCount(): number;
+    /**
+     * 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: string, channelName: string): BaseRealtimeChannelServer | null;
+    /**
+     * 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: string): RealtimeToolDefinition[];
+    /**
+     * 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).
+     */
+    ExecuteSessionServerTool(agentSessionID: string, toolName: string, argsJson: string): Promise<ServerChannelToolResult>;
+    /** Returns `true` when the given tool name is owned by a live channel of the session. */
+    OwnsServerTool(agentSessionID: string, toolName: string): boolean;
+    /**
+     * 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.
+     */
+    private resolveToolOwner;
+    /**
+     * 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.
+     */
+    OnSessionStarted(ctx: RealtimeChannelServerContext, contextUser: UserInfo, provider: IMetadataProvider): Promise<void>;
+    /**
+     * 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.
+     */
+    OnChannelStateSave(agentSessionID: string, channelName: string, stateJson: string): Promise<string>;
+    /**
+     * 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.
+     */
+    OnSessionClosed(agentSessionID: string, closeReason: RealtimeChannelCloseReason | null): Promise<void>;
+    /** Disposes the session's plugins now, or after the linger window when one is configured. */
+    private scheduleDisposal;
+    /** Disposes and forgets every plugin instance of one session (failures logged per plugin). */
+    private disposeSession;
+    /**
+     * 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.
+     */
+    private fetchChannelDefinitions;
+    /** Resolves + start-brackets one fresh plugin instance per resolvable registry row. */
+    private instantiateSessionPlugins;
+    /**
+     * 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.
+     */
+    private resolveChannelPlugin;
+    /** Disposes a plugin defensively, swallowing (logging) any error. */
+    private safeDispose;
+    /** Canonical map key for a session id (UUID case differs across DB platforms). */
+    private sessionKey;
+    /** Canonical map key for a channel name. */
+    private channelKey;
+    /** Normalizes an unknown thrown value into a loggable message. */
+    private message;
+}
+//# sourceMappingURL=realtime-channel-server-host.d.ts.map

package/dist/realtime/realtime-channel-server-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-channel-server-host.d.ts","sourceRoot":"","sources":["../../src/realtime/realtime-channel-server-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EACH,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAY,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAuB,MAAM,sBAAsB,CAAC;AA6BxF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,yBAA0B,SAAQ,aAAa,CAAC,yBAAyB,CAAC;IACnF,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAyC;IAEzD;;;;OAIG;IACI,eAAe,SAA6B;IAEnD,SAAS;IAIT,8FAA8F;IAC9F,WAAkB,QAAQ,IAAI,yBAAyB,CAEtD;IAED,uFAAuF;IACvF,IAAW,kBAAkB,IAAI,MAAM,CAEtC;IAED;;;;OAIG;IACI,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;IAWtG;;;;;;;;;;;OAWG;IACI,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAsB9E;;;;;;;;;;;;;;OAcG;IACU,wBAAwB,CACjC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,CAAC;IAenC,yFAAyF;IAClF,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxE;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;;;;OASG;IACU,gBAAgB,CACzB,GAAG,EAAE,4BAA4B,EACjC,WAAW,EAAE,QAAQ,EACrB,QAAQ,EAAE,iBAAiB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;;;;;;OAQG;IACU,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBhH;;;;;;;OAOG;IACU,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnH,6FAA6F;IAC7F,OAAO,CAAC,gBAAgB;IAUxB,8FAA8F;IAC9F,OAAO,CAAC,cAAc;IAetB;;;;;;OAMG;YACW,uBAAuB;IAoBrC,uFAAuF;YACzE,yBAAyB;IAyBvC;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAyB5B,qEAAqE;IACrE,OAAO,CAAC,WAAW;IAQnB,kFAAkF;IAClF,OAAO,CAAC,UAAU;IAIlB,4CAA4C;IAC5C,OAAO,CAAC,UAAU;IAIlB,kEAAkE;IAClE,OAAO,CAAC,OAAO;CAGlB"}