@memberjunction/ai-agents 6.2.0-edge.3 → 6.2.0-edge.4

package/dist/realtime/bridge-realtime-session-factory.js

@@ -18,11 +18,12 @@
  */
 import { BaseRealtimeModel, MakeAIAPIKeyResolver } from '@memberjunction/ai';
 import { Metadata } from '@memberjunction/core';
-import { MJGlobal, UUIDsEqual } from '@memberjunction/global';
+import { MJGlobal, UUIDsEqual, IndexByUUID } from '@memberjunction/global';
 import { AIEngine } from '@memberjunction/aiengine';
 import { BaseAgent } from '../base-agent.js';
 import { RealtimeClientSessionService } from './realtime-client-session-service.js';
 import { SelectRealtimeVendorForModel } from './realtime-vendor-resolution.js';
+import { RealtimeModelShowsAvatar } from './realtime-video-output-gate.js';
 /**
  * Opens a raw {@link IRealtimeSession} for the agent named in `ctx`. Bind this onto a bridge's
  * session-factory seam (e.g. `LiveKitAgentRoomCoordinator.Instance.SetSessionFactory(CreateBridgeRealtimeSession)`).
@@ -131,6 +132,9 @@ function buildRealtimeData(ctx) {
     if (ctx.HostTools && ctx.HostTools.length > 0) {
         data.realtimeHostTools = ctx.HostTools;
     }
+    if (ctx.ResolveHostTools) {
+        data.resolveHostTools = ctx.ResolveHostTools;
+    }
     if (ctx.HostFraming && ctx.HostFraming.trim().length > 0) {
         data.realtimeHostFraming = ctx.HostFraming.trim();
     }
@@ -143,6 +147,12 @@ function buildRealtimeData(ctx) {
     if (ctx.SelfNames && ctx.SelfNames.length > 0) {
         data.realtimeSelfNames = ctx.SelfNames;
     }
+    if (ctx.AvatarDelivery === 'room') {
+        data.realtimeAvatarDelivery = 'room';
+    }
+    if (ctx.PhoneCall === true) {
+        data.realtimePhoneCall = true;
+    }
     return Object.keys(data).length > 0 ? data : undefined;
 }
 /**
@@ -168,6 +178,12 @@ export async function FinalizeBridgeCoAgentRuns(agentSessionID, success, context
  * model/voice picker. Only models with an Active vendor + resolvable API key + ClassFactory driver are
  * returned (a model you can't actually run isn't worth offering). Voices come from the driver
  * ({@link BaseRealtimeModel.SupportedVoices}) — the near-term, driver-owned source of truth.
+ * A persona voice whose persona also has a preset Video binding on the same vendor names that avatar
+ * ({@link RealtimeModelVoiceOption.AvatarID}), when the model shows avatars on that vendor
+ * ({@link RealtimeModelShowsAvatar}: its Video/Output row allows video or it has none, and the driver
+ * renders avatars on its endpoint); driver voices never do. So the picker marks a voice "Comes with an
+ * avatar" only where a call can show one. A persona with a face doesn't stand in for its plain voice, so
+ * the plain voice is listed too.
  *
  * @param contextUser The user the engine config runs as (server-side).
  * @param provider The request-scoped metadata provider (multi-provider safe).
@@ -189,30 +205,62 @@ export async function GetRealtimeModelVoices(contextUser, provider, resolveAPIKe
         if (!driverClass) {
             continue; // no active vendor with a resolvable key — not runnable, so omit
         }
-        // 1. Consult metadata first (Personas & PersonaVendors carry curated names/descriptions)
-        const modelPersonas = AIEngine.Instance.GetModelPersonas(model.ID, 'Audio', selection.VendorID);
-        const voices = modelPersonas.map((rp) => ({
-            ID: rp.PersonaVendor.APIName,
-            Name: rp.Persona.Name,
-        }));
-        // Collect explicitly excluded voice IDs (IsSupported === false) for this model and vendor
-        const excludedVoiceApiNames = new Set(AIEngine.Instance.GetModelPersonaExclusions(model.ID, 'Audio', selection.VendorID)
-            .map((name) => name.toLowerCase()));
-        // 2. Union with driver SupportedVoices: append any driver voices not already present or explicitly excluded
         const instance = MJGlobal.Instance.ClassFactory.CreateInstance(BaseRealtimeModel, driverClass, resolveAPIKey(driverClass));
-        for (const dv of instance?.SupportedVoices ?? []) {
-            const dvIdLower = dv.ID.toLowerCase();
-            if (excludedVoiceApiNames.has(dvIdLower)) {
-                continue;
-            }
-            if (!voices.some((v) => v.ID.toLowerCase() === dvIdLower)) {
-                voices.push(dv);
-            }
-        }
+        // 1. Consult metadata first (Personas & PersonaVendors carry curated names/descriptions, and avatars where the
+        //    model shows them on this vendor)
+        const showsAvatar = instance ? RealtimeModelShowsAvatar({ ModelID: model.ID, APIName: selection.APIName, Model: instance }, AIEngine.Instance) : false;
+        const voices = personaVoiceOptions(model.ID, selection.VendorID, showsAvatar);
+        // 2. Union with driver SupportedVoices: append the driver voices no persona offers plainly, unless excluded
+        appendDriverVoices(voices, instance?.SupportedVoices ?? [], model.ID, selection.VendorID);
         out.push({ ModelID: model.ID, ModelName: model.Name ?? '', Voices: voices });
     }
     return out;
 }
+/**
+ * Appends the driver's voices that no persona already offers as a plain voice (without a face), skipping the ones the
+ * model explicitly excludes (`IsSupported === false`). A persona with a face doesn't stand in for its plain voice, so the
+ * voice stays pickable without the face. Driver voices have no persona: no avatar, no image.
+ */
+function appendDriverVoices(voices, driverVoices, modelID, vendorID) {
+    const excluded = new Set(AIEngine.Instance.GetModelPersonaExclusions(modelID, 'Audio', vendorID).map((name) => name.toLowerCase()));
+    for (const dv of driverVoices) {
+        const id = dv.ID.toLowerCase();
+        if (!excluded.has(id) && !voices.some((v) => !v.AvatarID && v.ID.toLowerCase() === id)) {
+            voices.push({ ID: dv.ID, Name: dv.Name });
+        }
+    }
+}
+/**
+ * The model's persona voices on a vendor, one per persona, in persona order. On a model that shows avatars there, a
+ * persona whose preset Video binding on the same vendor the model supports carries that binding's `APIName` as its avatar
+ * (the face the session asks for when the voice is picked); a binding on any other vendor doesn't count, nor does a custom
+ * one, and with no vendor there is nothing to match. On a model that shows none, no voice comes with an avatar.
+ *
+ * @param showsAvatar Whether the model shows avatars on this vendor ({@link RealtimeModelShowsAvatar}).
+ */
+function personaVoiceOptions(modelID, vendorID, showsAvatar) {
+    const faces = vendorID && showsAvatar ? AIEngine.Instance.GetModelPersonas(modelID, 'Video', vendorID).filter(isPresetFace) : [];
+    // First face per persona wins, as faces.find() would.
+    const facesByPersona = IndexByUUID(faces, (f) => f.Persona.ID);
+    return AIEngine.Instance.GetModelPersonas(modelID, 'Audio', vendorID).map((voice) => {
+        const face = facesByPersona.Get(voice.Persona.ID);
+        const image = voice.Persona.PreviewImageURL?.trim();
+        return {
+            ID: voice.PersonaVendor.APIName,
+            Name: voice.Persona.Name,
+            PersonaID: voice.Persona.ID,
+            ...(face ? { AvatarID: face.PersonaVendor.APIName.trim() } : {}),
+            ...(image ? { PreviewImageURL: image } : {}),
+        };
+    });
+}
+/**
+ * Whether a Video binding is a face a picked voice can bring: a preset (`Avatar.Kind` absent or `'preset'`). Custom avatars
+ * are not supported, so a session asking for one would stay audio only.
+ */
+function isPresetFace(face) {
+    return (face.PersonaVendor.VendorSettingsObject?.Avatar?.Kind ?? 'preset') !== 'custom';
+}
 /** Resolves the agent entity from the engine cache by id (preferred), then by case-insensitive name. */
 function resolveAgentEntity(ctx) {
     const agents = AIEngine.Instance.Agents;

package/dist/realtime/bridge-realtime-session-factory.js.map

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

package/dist/realtime/bridge-realtime-usage-recorder.d.ts

@@ -0,0 +1,81 @@
+import type { RealtimeUsage } from '@memberjunction/ai';
+import { type RealtimeUsageRecord } from '@memberjunction/ai-engine-base';
+/** How long after the first unwritten update the recorder writes, in milliseconds. */
+export declare const BRIDGE_USAGE_FLUSH_MS = 10000;
+/** One write: the token amounts since the previous write, and the per-modality usage. */
+export interface BridgeUsageWrite {
+    /** Input tokens to add. */
+    InputTokens: number;
+    /** Output tokens to add. */
+    OutputTokens: number;
+    /** Per-modality amounts to add, and the latest running totals; absent when the session reported none. */
+    Details?: RealtimeUsageRecord;
+}
+/** Stores one {@link BridgeUsageWrite}; resolves `false` when nothing was stored. */
+export type BridgeUsageWriter = (write: BridgeUsageWrite) => Promise<boolean>;
+/** What a recorder has accepted over its life, for the session's closing log line. */
+export interface BridgeUsageTotals {
+    InputTokens: number;
+    OutputTokens: number;
+    /** Seconds of video the model generated (an avatar). */
+    OutputVideoSeconds: number;
+}
+/**
+ * Adds up one bridged session's usage and writes it on a timer and at close. A failed write keeps its usage for the
+ * next one; the write at close is the last attempt.
+ */
+export declare class BridgeRealtimeUsageRecorder {
+    private readonly writer;
+    private readonly label;
+    private readonly flushMs;
+    private inputTokens;
+    private outputTokens;
+    private details;
+    private timer;
+    private writeChain;
+    private closed;
+    private lateUpdateLogged;
+    private readonly accepted;
+    /**
+     * @param writer Stores one write.
+     * @param label Names the session in log lines (for example its prompt run id).
+     * @param flushMs How long after the first unwritten update to write.
+     */
+    constructor(writer: BridgeUsageWriter, label: string, flushMs?: number);
+    /** What the recorder has accepted so far. */
+    get Totals(): Readonly<BridgeUsageTotals>;
+    /** Whether the recorder holds usage that is not written yet. */
+    get HasUnwrittenUsage(): boolean;
+    /**
+     * Takes one `OnUsage` update. An update that adds nothing is ignored; the first one that does starts the write timer.
+     * After {@link Close} an update is dropped, and the first one dropped is logged.
+     *
+     * @param usage The update the session reported.
+     */
+    Add(usage: RealtimeUsage): void;
+    /** Writes what is unwritten now, after any write in progress. Never rejects. */
+    Flush(): Promise<void>;
+    /**
+     * Stops taking updates and writes what is unwritten. When that last write fails, its amounts are logged and dropped.
+     * Safe to call more than once.
+     */
+    Close(): Promise<void>;
+    /** Adds the update's token totals to the unwritten ones. Returns whether it added anything. */
+    private addTokens;
+    /** Adds the update's per-modality usage and session duration to the unwritten record. Returns whether it held any. */
+    private addDetails;
+    /** Starts the write timer unless one is running. The timer never keeps the process alive. */
+    private armWrite;
+    private clearTimer;
+    /** Writes the unwritten usage once; a failed write puts its usage back. */
+    private writeUnwritten;
+    /** Moves the unwritten usage into a write, or returns `null` when there is none. */
+    private takeUnwritten;
+    /** Puts a failed write's usage back, together with what arrived since. */
+    private putBack;
+    /** Forgets the unwritten usage. */
+    private clearUnwritten;
+    /** Logs the first update dropped after close. */
+    private logLateUpdate;
+}
+//# sourceMappingURL=bridge-realtime-usage-recorder.d.ts.map

package/dist/realtime/bridge-realtime-usage-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-realtime-usage-recorder.d.ts","sourceRoot":"","sources":["../../src/realtime/bridge-realtime-usage-recorder.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAA4C,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAEpH,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC7B,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,yGAAyG;IACzG,OAAO,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9E,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,2BAA2B;IAgBhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAjB5B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiF;IAE1G;;;;OAIG;gBAEkB,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAA8B;IAG5D,6CAA6C;IAC7C,IAAW,MAAM,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAE/C;IAED,gEAAgE;IAChE,IAAW,iBAAiB,IAAI,OAAO,CAEtC;IAED;;;;;OAKG;IACI,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAYtC,gFAAgF;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBnC,+FAA+F;IAC/F,OAAO,CAAC,SAAS;IAejB,sHAAsH;IACtH,OAAO,CAAC,UAAU;IAclB,6FAA6F;IAC7F,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,UAAU;IAOlB,2EAA2E;YAC7D,cAAc;IAgB5B,oFAAoF;IACpF,OAAO,CAAC,aAAa;IAarB,0EAA0E;IAC1E,OAAO,CAAC,OAAO;IAQf,mCAAmC;IACnC,OAAO,CAAC,cAAc;IAMtB,iDAAiD;IACjD,OAAO,CAAC,aAAa;CAUxB"}

package/dist/realtime/bridge-realtime-usage-recorder.js

@@ -0,0 +1,194 @@
+/**
+ * @fileoverview Records the usage a server-held (bridged) realtime session reports. It adds up the session's `OnUsage`
+ * updates and writes them through a writer (the co-agent prompt run's usage accumulation) {@link BRIDGE_USAGE_FLUSH_MS}
+ * after the first unwritten update, and once more when it is closed, so the run is priced at finalize from its final
+ * counts. After it is closed it stores nothing more. Per-modality usage follows the realtime usage record's rules
+ * (`AddRealtimeUsageRecord`): amounts add up, running totals keep the larger value.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { LogError, LogStatus, LogStatusEx } from '@memberjunction/core';
+import { AddRealtimeUsageRecord, HasRealtimeUsage } from '@memberjunction/ai-engine-base';
+/** How long after the first unwritten update the recorder writes, in milliseconds. */
+export const BRIDGE_USAGE_FLUSH_MS = 10_000;
+/**
+ * Adds up one bridged session's usage and writes it on a timer and at close. A failed write keeps its usage for the
+ * next one; the write at close is the last attempt.
+ */
+export class BridgeRealtimeUsageRecorder {
+    /**
+     * @param writer Stores one write.
+     * @param label Names the session in log lines (for example its prompt run id).
+     * @param flushMs How long after the first unwritten update to write.
+     */
+    constructor(writer, label, flushMs = BRIDGE_USAGE_FLUSH_MS) {
+        this.writer = writer;
+        this.label = label;
+        this.flushMs = flushMs;
+        this.inputTokens = 0;
+        this.outputTokens = 0;
+        this.details = null;
+        this.timer = null;
+        this.writeChain = Promise.resolve();
+        this.closed = false;
+        this.lateUpdateLogged = false;
+        this.accepted = { InputTokens: 0, OutputTokens: 0, OutputVideoSeconds: 0 };
+    }
+    /** What the recorder has accepted so far. */
+    get Totals() {
+        return this.accepted;
+    }
+    /** Whether the recorder holds usage that is not written yet. */
+    get HasUnwrittenUsage() {
+        return this.inputTokens > 0 || this.outputTokens > 0 || HasRealtimeUsage(this.details);
+    }
+    /**
+     * Takes one `OnUsage` update. An update that adds nothing is ignored; the first one that does starts the write timer.
+     * After {@link Close} an update is dropped, and the first one dropped is logged.
+     *
+     * @param usage The update the session reported.
+     */
+    Add(usage) {
+        if (this.closed) {
+            this.logLateUpdate(usage);
+            return;
+        }
+        const addedTokens = this.addTokens(usage);
+        const addedDetails = this.addDetails(usage);
+        if (addedTokens || addedDetails) {
+            this.armWrite();
+        }
+    }
+    /** Writes what is unwritten now, after any write in progress. Never rejects. */
+    Flush() {
+        this.clearTimer();
+        this.writeChain = this.writeChain.then(() => this.writeUnwritten());
+        return this.writeChain;
+    }
+    /**
+     * Stops taking updates and writes what is unwritten. When that last write fails, its amounts are logged and dropped.
+     * Safe to call more than once.
+     */
+    async Close() {
+        if (this.closed) {
+            await this.writeChain;
+            return;
+        }
+        this.closed = true;
+        await this.Flush();
+        if (this.HasUnwrittenUsage) {
+            LogError(`[Bridged usage] ${this.label}: the last usage write failed; not stored: ${this.inputTokens} input and ` +
+                `${this.outputTokens} output tokens.`);
+            this.clearUnwritten();
+        }
+        LogStatusEx({
+            message: `[Bridged usage] ${this.label}: ${this.accepted.InputTokens} input and ${this.accepted.OutputTokens} output ` +
+                `tokens, ${this.accepted.OutputVideoSeconds} s of generated video.`,
+            verboseOnly: true,
+        });
+    }
+    /** Adds the update's token totals to the unwritten ones. Returns whether it added anything. */
+    addTokens(usage) {
+        let added = false;
+        if (isAmount(usage.InputTokens)) {
+            this.inputTokens += usage.InputTokens;
+            this.accepted.InputTokens += usage.InputTokens;
+            added = true;
+        }
+        if (isAmount(usage.OutputTokens)) {
+            this.outputTokens += usage.OutputTokens;
+            this.accepted.OutputTokens += usage.OutputTokens;
+            added = true;
+        }
+        return added;
+    }
+    /** Adds the update's per-modality usage and session duration to the unwritten record. Returns whether it held any. */
+    addDetails(usage) {
+        const update = AddRealtimeUsageRecord(null, {
+            Input: usage.InputTokenDetails,
+            Output: usage.OutputTokenDetails,
+            DurationSeconds: usage.DurationSeconds,
+        });
+        if (!HasRealtimeUsage(update)) {
+            return false;
+        }
+        this.details = AddRealtimeUsageRecord(this.details, update);
+        this.accepted.OutputVideoSeconds += update.Output?.VideoSeconds ?? 0;
+        return true;
+    }
+    /** Starts the write timer unless one is running. The timer never keeps the process alive. */
+    armWrite() {
+        if (this.timer) {
+            return;
+        }
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.Flush();
+        }, this.flushMs);
+        this.timer.unref?.();
+    }
+    clearTimer() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Writes the unwritten usage once; a failed write puts its usage back. */
+    async writeUnwritten() {
+        const write = this.takeUnwritten();
+        if (!write) {
+            return;
+        }
+        let stored = false;
+        try {
+            stored = await this.writer(write);
+        }
+        catch (error) {
+            LogError(`[Bridged usage] ${this.label}: writing usage failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!stored) {
+            this.putBack(write);
+        }
+    }
+    /** Moves the unwritten usage into a write, or returns `null` when there is none. */
+    takeUnwritten() {
+        if (!this.HasUnwrittenUsage) {
+            return null;
+        }
+        const write = {
+            InputTokens: this.inputTokens,
+            OutputTokens: this.outputTokens,
+            ...(this.details && HasRealtimeUsage(this.details) ? { Details: this.details } : {}),
+        };
+        this.clearUnwritten();
+        return write;
+    }
+    /** Puts a failed write's usage back, together with what arrived since. */
+    putBack(write) {
+        this.inputTokens += write.InputTokens;
+        this.outputTokens += write.OutputTokens;
+        if (write.Details) {
+            this.details = AddRealtimeUsageRecord(write.Details, this.details ?? {});
+        }
+    }
+    /** Forgets the unwritten usage. */
+    clearUnwritten() {
+        this.inputTokens = 0;
+        this.outputTokens = 0;
+        this.details = null;
+    }
+    /** Logs the first update dropped after close. */
+    logLateUpdate(usage) {
+        if (this.lateUpdateLogged) {
+            return;
+        }
+        this.lateUpdateLogged = true;
+        LogStatus(`[Bridged usage] ${this.label}: usage reported after the session's run was finalized is not stored ` +
+            `(first dropped: ${usage.InputTokens} input and ${usage.OutputTokens} output tokens).`);
+    }
+}
+/** Whether a reported token total is one to add: a finite number above zero. */
+function isAmount(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0;
+}
+//# sourceMappingURL=bridge-realtime-usage-recorder.js.map

package/dist/realtime/bridge-realtime-usage-recorder.js.map

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

package/dist/realtime/client-only-channel-server.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview A generic server half for channels that run entirely in the browser.
+ *
+ * `MJ: AI Agent Channels.ServerPluginClass` is `NOT NULL`: every channel in the registry names a server plugin, even a
+ * channel whose verbs, state and surface all live in the client. Without this class each such channel (an Open App's
+ * form channel, a game, a component host) would hand-write the same empty plugin. A client-only channel instead
+ * points its registry row at this one:
+ *
+ * ```json
+ * { "fields": { "Name": "YourChannel", "ServerPluginClass": "ClientOnlyChannelServer", "ClientPluginClass": "YourChannel", ... } }
+ * ```
+ *
+ * The plugin takes its channel name from the registry row it was resolved for (see {@link ClientOnlyChannelServer.BindChannelName}),
+ * so one registered class serves any number of channels and `RealtimeChannelServerHost` never reports a name mismatch.
+ *
+ * ## What it does
+ *
+ * - Completes the registry pairing, so the channel is discoverable, scoped and killable like every other.
+ * - Contributes **no server tools** (`GetServerToolDefinitions()` is `[]`): every verb executes in the browser.
+ * - Does **not interpret or rewrite** a state-of-record save (`OnChannelStateSave` returns `null`, which the host reads as
+ *   "keep what the client sent").
+ *
+ * ## What it does not do
+ *
+ * - **It does not decide scope.** Whether the channel is in a session at all is resolved by the channel-scoping cascade
+ *   (`channels.include` / `exclude` / the registry's `IsActive` kill switch) BEFORE the host creates any plugin, so there is
+ *   nothing left for a plugin to validate.
+ * - **It does not stop a save.** The host treats a plugin's `null` (and any thrown error) as "persist the original", so a
+ *   server plugin cannot refuse state. Whether anything is persisted is decided by the CLIENT: a channel with no state of
+ *   record (`SerializeState()` returns `null`, so it never requests a save) persists nothing. A channel that does request
+ *   saves, such as an `AngularComponentChannel`, has its state stored on the session's channel row as submitted; if that state
+ *   must not be stored, validate or redact it in a server plugin of your own (return a replacement) or do not save it.
+ * - **It does not authorize anything.** If the channel's verbs call server operations, those operations are the security
+ *   boundary (they run on the session's own principal); a client-only channel adds no door of its own.
+ *
+ * Use a dedicated server plugin instead when the channel needs server tools, a server-side state normalizer, or
+ * session-lifecycle work.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+import { BaseRealtimeChannelServer, RealtimeToolDefinition } from '@memberjunction/ai';
+/** The `ServerPluginClass` key a client-only channel's registry row uses. */
+export declare const CLIENT_ONLY_CHANNEL_SERVER_KEY = "ClientOnlyChannelServer";
+/**
+ * Generic server half for a channel that runs entirely in the browser. One instance per realtime session (created by
+ * `RealtimeChannelServerHost` from the channel registry; never construct directly).
+ *
+ * Subclass it only to pin a fixed {@link ChannelName} under a key of your own (as the built-in Interactive Component and
+ * Identity Verification channels do, so their existing registry keys keep resolving); an Open App should simply use the
+ * registered `ClientOnlyChannelServer` key.
+ */
+export declare class ClientOnlyChannelServer extends BaseRealtimeChannelServer {
+    private boundChannelName;
+    /**
+     * The channel this instance serves: the registry row's `Name`, once the host has bound it; `''` before that. A subclass
+     * that pins a fixed name overrides it.
+     */
+    get ChannelName(): string;
+    /**
+     * Tells the plugin which registry row it was resolved for. Called by `RealtimeChannelServerHost` right after it creates
+     * the instance, so a single registered class can serve any client-only channel.
+     *
+     * @param channelName The registry row's `Name`.
+     */
+    BindChannelName(channelName: string): void;
+    /** No server-executed tools: every verb runs in the browser. */
+    GetServerToolDefinitions(): RealtimeToolDefinition[];
+    /**
+     * Does not interpret or rewrite a state save. `null` means "persist what the client submitted" (the host cannot refuse a
+     * save through a plugin; see the file comment).
+     *
+     * @returns `null`.
+     */
+    OnChannelStateSave(): Promise<string | null>;
+}
+/**
+ * Tree-shaking prevention for {@link ClientOnlyChannelServer}'s `@RegisterClass` registration. Called from a static code
+ * path in the server host (and, for the Interactive Component and Identity Verification plugins, from their own load
+ * functions) so the registration always executes.
+ */
+export declare function LoadClientOnlyChannelServer(): void;
+//# sourceMappingURL=client-only-channel-server.d.ts.map

package/dist/realtime/client-only-channel-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-only-channel-server.d.ts","sourceRoot":"","sources":["../../src/realtime/client-only-channel-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGvF,6EAA6E;AAC7E,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AAExE;;;;;;;GAOG;AACH,qBACa,uBAAwB,SAAQ,yBAAyB;IAClE,OAAO,CAAC,gBAAgB,CAAuB;IAE/C;;;OAGG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED;;;;;OAKG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIjD,gEAAgE;IAChD,wBAAwB,IAAI,sBAAsB,EAAE;IAIpE;;;;;OAKG;IACmB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGrE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}