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

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/bridge-session-transcript-sink.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview `CreateBridgeSessionTranscriptSink` — persists a bridged call's transcript into the
+ * `MJ: Conversations` row that belongs to THAT session.
+ *
+ * The room sink ({@link CreateBridgeRoomTranscriptSink}) is the right shape for a multi-party meeting: one
+ * "Meeting Room" conversation per room, written by an elected scribe. A phone call is the opposite — one
+ * session, one remote party, a conversation the session manager already created. Routing a call through the
+ * room sink wrote its transcript into a separate global conversation owned by the system user while the call's
+ * own conversation stayed empty. This sink writes each final line to the session's own conversation, in order,
+ * the same way the browser path does (`AgentSessionID` and `UserID` stamped on every turn).
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+import type { BridgeRoomTranscriptSink } from './bridge-room-transcript-sink.js';
+/** What identifies the conversation a session's transcript belongs to. */
+export interface BridgeSessionTranscriptSinkOptions {
+    /** The `MJ: Conversations` row to write turns into (the one the session manager created for the call). */
+    ConversationID: string;
+    /** The `MJ: AI Agent Sessions` row the turns belong to. */
+    AgentSessionID: string;
+    /**
+     * The agent attributed on the agent's own turns. Defaults to the line's agent (the voicing co-agent); a call
+     * passes the TARGET agent instead, since that is the persona the caller believes they are talking to.
+     */
+    AgentID?: string;
+}
+/**
+ * Builds a transcript sink bound to one session's conversation. Pass the result as
+ * `StartBridgeSessionParams.TranscriptSink`. Writes are serialized so turns land in the order they were spoken,
+ * and a failed write is logged without blocking the ones behind it.
+ *
+ * @param options The conversation, session and (optional) agent attribution.
+ * @returns The sink.
+ */
+export declare function CreateBridgeSessionTranscriptSink(options: BridgeSessionTranscriptSinkOptions): BridgeRoomTranscriptSink;
+//# sourceMappingURL=bridge-session-transcript-sink.d.ts.map

package/dist/realtime/bridge-session-transcript-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-session-transcript-sink.d.ts","sourceRoot":"","sources":["../../src/realtime/bridge-session-transcript-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,wBAAwB,EAA6B,MAAM,+BAA+B,CAAC;AAEzG,0EAA0E;AAC1E,MAAM,WAAW,kCAAkC;IAC/C,0GAA0G;IAC1G,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,kCAAkC,GAAG,wBAAwB,CAUvH"}

package/dist/realtime/bridge-session-transcript-sink.js

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview `CreateBridgeSessionTranscriptSink` — persists a bridged call's transcript into the
+ * `MJ: Conversations` row that belongs to THAT session.
+ *
+ * The room sink ({@link CreateBridgeRoomTranscriptSink}) is the right shape for a multi-party meeting: one
+ * "Meeting Room" conversation per room, written by an elected scribe. A phone call is the opposite — one
+ * session, one remote party, a conversation the session manager already created. Routing a call through the
+ * room sink wrote its transcript into a separate global conversation owned by the system user while the call's
+ * own conversation stayed empty. This sink writes each final line to the session's own conversation, in order,
+ * the same way the browser path does (`AgentSessionID` and `UserID` stamped on every turn).
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+import { LogError } from '@memberjunction/core';
+const CONVERSATION_DETAIL_ENTITY = 'MJ: Conversation Details';
+/**
+ * Builds a transcript sink bound to one session's conversation. Pass the result as
+ * `StartBridgeSessionParams.TranscriptSink`. Writes are serialized so turns land in the order they were spoken,
+ * and a failed write is logged without blocking the ones behind it.
+ *
+ * @param options The conversation, session and (optional) agent attribution.
+ * @returns The sink.
+ */
+export function CreateBridgeSessionTranscriptSink(options) {
+    let chain = Promise.resolve();
+    return (line, contextUser, provider) => {
+        if (!contextUser || !provider) {
+            return Promise.resolve(); // a server-side write needs a user + provider
+        }
+        const write = chain.then(() => WriteSessionTurn(options, line, contextUser, provider));
+        chain = write.then(() => undefined, () => undefined);
+        return write;
+    };
+}
+/** Writes one `MJ: Conversation Details` row for a final transcript line. Never throws. */
+async function WriteSessionTurn(options, line, contextUser, provider) {
+    try {
+        const detail = await provider.GetEntityObject(CONVERSATION_DETAIL_ENTITY, contextUser);
+        detail.NewRecord();
+        detail.ConversationID = options.ConversationID;
+        detail.Role = line.IsAgentSpeech ? 'AI' : 'User';
+        detail.Message = line.Text;
+        detail.AgentSessionID = options.AgentSessionID;
+        detail.UserID = contextUser.ID;
+        const agentID = options.AgentID ?? line.AgentID;
+        if (line.IsAgentSpeech && agentID) {
+            detail.AgentID = agentID;
+        }
+        if (!(await detail.Save())) {
+            LogError(`CreateBridgeSessionTranscriptSink: failed to write a transcript turn for session ${options.AgentSessionID}: ${detail.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+    }
+    catch (error) {
+        LogError(`CreateBridgeSessionTranscriptSink: transcript write threw for session ${options.AgentSessionID}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=bridge-session-transcript-sink.js.map

package/dist/realtime/bridge-session-transcript-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-session-transcript-sink.js","sourceRoot":"","sources":["../../src/realtime/bridge-session-transcript-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAqB,QAAQ,EAAY,MAAM,sBAAsB,CAAC;AAiB7E,MAAM,0BAA0B,GAAG,0BAA0B,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAA2C;IACzF,IAAI,KAAK,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7C,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE;QACnC,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,8CAA8C;QAC5E,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QACvF,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC;AACN,CAAC;AAED,2FAA2F;AAC3F,KAAK,UAAU,gBAAgB,CAC3B,OAA2C,EAC3C,IAA+B,EAC/B,WAAqB,EACrB,QAA2B;IAE3B,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAA6B,0BAA0B,EAAE,WAAW,CAAC,CAAC;QACnH,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC/C,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACjD,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3B,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC/C,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;QAChD,IAAI,IAAI,CAAC,aAAa,IAAI,OAAO,EAAE,CAAC;YAChC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,oFAAoF,OAAO,CAAC,cAAc,KAAK,MAAM,CAAC,YAAY,EAAE,eAAe,IAAI,eAAe,EAAE,CAAC,CAAC;QACvL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,QAAQ,CAAC,yEAAyE,OAAO,CAAC,cAAc,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3K,CAAC;AACL,CAAC"}

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"}

package/dist/realtime/client-only-channel-server.js

@@ -0,0 +1,107 @@
+/**
+ * @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
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseRealtimeChannelServer } from '@memberjunction/ai';
+import { RegisterClass } from '@memberjunction/global';
+/** The `ServerPluginClass` key a client-only channel's registry row uses. */
+export 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.
+ */
+let ClientOnlyChannelServer = class ClientOnlyChannelServer extends BaseRealtimeChannelServer {
+    constructor() {
+        super(...arguments);
+        this.boundChannelName = null;
+    }
+    /**
+     * 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() {
+        return this.boundChannelName ?? '';
+    }
+    /**
+     * 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) {
+        this.boundChannelName = channelName;
+    }
+    /** No server-executed tools: every verb runs in the browser. */
+    GetServerToolDefinitions() {
+        return [];
+    }
+    /**
+     * 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`.
+     */
+    async OnChannelStateSave() {
+        return null;
+    }
+};
+ClientOnlyChannelServer = __decorate([
+    RegisterClass(BaseRealtimeChannelServer, CLIENT_ONLY_CHANNEL_SERVER_KEY)
+], ClientOnlyChannelServer);
+export { ClientOnlyChannelServer };
+/**
+ * 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 function LoadClientOnlyChannelServer() {
+    // no-op: the import + call create a static reference bundlers cannot eliminate
+}
+//# sourceMappingURL=client-only-channel-server.js.map

package/dist/realtime/client-only-channel-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-only-channel-server.js","sourceRoot":"","sources":["../../src/realtime/client-only-channel-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;;;;;;;AAEH,OAAO,EAAE,yBAAyB,EAA0B,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,yBAAyB,CAAC;AAExE;;;;;;;GAOG;AAEI,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,yBAAyB;IAA/D;;QACK,qBAAgB,GAAkB,IAAI,CAAC;IAkCnD,CAAC;IAhCG;;;OAGG;IACH,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACI,eAAe,CAAC,WAAmB;QACtC,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC;IACxC,CAAC;IAED,gEAAgE;IAChD,wBAAwB;QACpC,OAAO,EAAE,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACa,KAAK,CAAC,kBAAkB;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ,CAAA;AAnCY,uBAAuB;IADnC,aAAa,CAAC,yBAAyB,EAAE,8BAA8B,CAAC;GAC5D,uBAAuB,CAmCnC;;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACvC,+EAA+E;AACnF,CAAC"}

package/dist/realtime/identity-verification-channel-server.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview Server-side channel plugin for the **Identity Verification** channel — the generic,
+ * opt-in channel through which a realtime agent helps a person (often an anonymous widget guest) prove
+ * they control an email address without leaving the call.
+ *
+ * Paired with the browser's `IdentityVerificationChannel` client plugin through the seeded
+ * `MJ: AI Agent Channels` row (`Name: 'IdentityVerification'`,
+ * `ServerPluginClass: 'IdentityVerificationChannelServer'`, `ClientPluginClass: 'IdentityVerificationChannel'`).
+ *
+ * **Why the server half is intentionally thin, and validates nothing beyond scope.** The channel's verbs
+ * are executed in the browser, which then calls the verification operations
+ * (`RequestRealtimeSessionVerification`, `SubmitRealtimeSessionVerificationCode`) on the session's own
+ * principal. Those operations — not this plugin — are the security boundary: domain policy, rate limits,
+ * code hashing, expiry and deadline extension all live in the verification service, and the server never
+ * trusts anything the client says about verification state. A server tool here would only be a second,
+ * weaker door to the same room, and a state of record would put an email address (PII) onto the session's
+ * channel row for no benefit — the session's verification state is already stored, hashed where it must
+ * be, on the session itself. So the plugin completes the registry pairing (so the channel is discoverable
+ * and scoped like every other) and contributes no server tools and no persisted state.
+ *
+ * "Scope" is the only thing that applies server-side: whether the channel is in a session at all is decided
+ * by the channel-scoping cascade (`channels.config.IdentityVerification`, opt-in by default) and the
+ * registry's kill switch, both resolved before this plugin is ever created.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+import { ClientOnlyChannelServer } from './client-only-channel-server.js';
+/** The stable channel name, matching the seeded `MJ: AI Agent Channels` row. */
+export declare const IDENTITY_VERIFICATION_CHANNEL_NAME = "IdentityVerification";
+/**
+ * Server half of the Identity Verification channel. One instance per realtime session (created by
+ * `RealtimeChannelServerHost` from the channel registry; never construct directly).
+ *
+ * A {@link ClientOnlyChannelServer} that pins the channel's name under its own, already-seeded registry key
+ * (`IdentityVerificationChannelServer`), so the existing row keeps resolving. It contributes no server tools and does not
+ * rewrite saves. The channel's state is a name and an email in a form: the client plugin has no state of record (it never
+ * requests a save), so no email address reaches the channel row. A server plugin cannot refuse a save, so that guarantee
+ * rests on the client plugin continuing not to request one.
+ */
+export declare class IdentityVerificationChannelServer extends ClientOnlyChannelServer {
+    /** Matches the seeded `MJ: AI Agent Channels` row's `Name`. */
+    get ChannelName(): string;
+}
+/**
+ * Tree-shaking prevention for {@link IdentityVerificationChannelServer}'s `@RegisterClass` registration.
+ * Called from a static code path in the server host so the registration always executes.
+ */
+export declare function LoadIdentityVerificationChannelServer(): void;
+//# sourceMappingURL=identity-verification-channel-server.d.ts.map