@memberjunction/realtime-runtime 6.2.0-edge.3 → 6.2.0-edge.5

package/dist/session/RecordingShardWindow.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Cuts a call's continuous Opus packet stream into indexed `MJOPUS1` shards.
+ *
+ * Shard boundaries are decided here, once, and never revisited: an index is only ever sent with
+ * one set of bytes (the server treats a differing resend as a conflict). That is why a tail that is
+ * sent early (page hidden) is *sealed* — later packets start a new shard at the next index.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { EncodeRecordingShard, RECORDING_FRAME_SAMPLES, RECORDING_PACKET_LENGTH_PREFIX_BYTES, RECORDING_SHARD_HEADER_BYTES, RECORDING_SHARD_MAX_PACKETS, RECORDING_TERMINAL_MAX_BYTES, } from '@memberjunction/ai-core-plus';
+/**
+ * Accumulates Opus packets and seals them into shards. Pure: no timers, no I/O.
+ *
+ * A window seals when it reaches {@link RECORDING_SHARD_MAX_PACKETS} packets (two 5 s windows), or
+ * just BEFORE a packet that would push the encoded shard past {@link RECORDING_TERMINAL_MAX_BYTES}.
+ * The runtime's 5 s tick seals whatever is pending, so a live call still cuts one ~5 s shard per tick;
+ * the packet cap only splits a backlog (a throttled tab's batch). The byte cap guarantees that
+ * whatever tail is pending always fits the terminal request body, even after a VBR spike.
+ */
+export class RecordingShardWindow {
+    constructor() {
+        this.pending = [];
+        this.pendingBytes = RECORDING_SHARD_HEADER_BYTES;
+        this.nextIndex = 0;
+        this.sealedSamples = 0;
+    }
+    /** Index of the last sealed shard; -1 before any seal. */
+    get LastSealedIndex() {
+        return this.nextIndex - 1;
+    }
+    /** End sample of the last sealed shard. */
+    get SealedSamples() {
+        return this.sealedSamples;
+    }
+    /** End sample of everything appended so far, sealed or pending. */
+    get PendingSamples() {
+        return this.sealedSamples + this.pending.length * RECORDING_FRAME_SAMPLES;
+    }
+    /** Adds packets in capture order and returns every shard that sealed as a result. */
+    Append(packets) {
+        const sealed = [];
+        for (const packet of packets) {
+            const cost = RECORDING_PACKET_LENGTH_PREFIX_BYTES + packet.length;
+            if (this.pending.length > 0 && this.pendingBytes + cost > RECORDING_TERMINAL_MAX_BYTES) {
+                sealed.push(this.seal(this.pending.length * RECORDING_FRAME_SAMPLES));
+            }
+            this.pending.push(packet);
+            this.pendingBytes += cost;
+            if (this.pending.length >= RECORDING_SHARD_MAX_PACKETS) {
+                sealed.push(this.seal(this.pending.length * RECORDING_FRAME_SAMPLES));
+            }
+        }
+        return sealed;
+    }
+    /**
+     * Seals the partial window now. `sampleCount` (default packets*960) is clamped to
+     * [0, packets*960]; the caller passes less when the encoder's last frame was padded. Returns null
+     * when no packets are pending, so a second call is a no-op.
+     */
+    SealTail(sampleCount) {
+        if (this.pending.length === 0) {
+            return null;
+        }
+        const max = this.pending.length * RECORDING_FRAME_SAMPLES;
+        const wanted = sampleCount ?? max;
+        return this.seal(Math.min(Math.max(Math.floor(wanted), 0), max));
+    }
+    seal(sampleCount) {
+        const shard = {
+            Index: this.nextIndex,
+            StartSample: this.sealedSamples,
+            SampleCount: sampleCount,
+            Bytes: EncodeRecordingShard({
+                ShardIndex: this.nextIndex,
+                StartSample: this.sealedSamples,
+                SampleCount: sampleCount,
+                PacketCount: this.pending.length,
+                Packets: this.pending,
+            }),
+        };
+        this.nextIndex++;
+        this.sealedSamples += sampleCount;
+        this.pending = [];
+        this.pendingBytes = RECORDING_SHARD_HEADER_BYTES;
+        return shard;
+    }
+}
+//# sourceMappingURL=RecordingShardWindow.js.map

package/dist/session/RecordingShardWindow.js.map

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

package/dist/session/RecordingTransport.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview `fetch` transport for recording shards and the terminal request.
+ *
+ * Shards travel as raw bytes (no base64, no GraphQL envelope) to MJAPI's REST recording routes. The
+ * terminal request sets `keepalive: true` so the browser completes it even while the page is
+ * unloading; that flag caps the body at 64 KiB, which is why the window seals tails under 48 KiB.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import type { RecordingShard } from './RecordingShardWindow.js';
+import type { PendingRecordingShard } from './RecordingShardStore.js';
+export interface RecordingTerminalInput {
+    /** The final partial shard's bytes, or null when every shard was already sent. */
+    Tail: Uint8Array | null;
+    LastShardIndex: number;
+    CapturedSamples: number;
+    /**
+     * False when the call may go on (the tab was only hidden): the server stamps the counts but assembles
+     * after its grace period instead of now. Absent or true: the call ended.
+     */
+    Final?: boolean;
+}
+/** Per-upload options for {@link IRecordingTransport.UploadShard}. */
+export interface RecordingUploadOptions {
+    /**
+     * Send with `keepalive` so the request survives page unload. Only for shards sealed inside a
+     * `pagehide`/`visibilitychange` handler: the browser caps in-flight keepalive bodies (64 KiB per
+     * page), and a request over that budget is refused — which resolves false like any failure.
+     */
+    Keepalive?: boolean;
+}
+/**
+ * What became of one shard upload. `Acked`: the server has it. `Refused`: the server answered that it
+ * will never take this shard (bad shard, not this caller's session, conflicting bytes, too late, too
+ * big), so re-sending it is pointless. `Retry`: anything that may succeed later (no network, an expired
+ * token, a busy or failing server).
+ */
+export type RecordingUploadOutcome = 'Acked' | 'Refused' | 'Retry';
+/** Sends recording bytes to the server. */
+export interface IRecordingTransport {
+    UploadShard(sessionID: string, shard: RecordingShard | PendingRecordingShard, options?: RecordingUploadOptions): Promise<RecordingUploadOutcome>;
+    /** Sent with `keepalive` so it survives page unload. Resolves true only on a server ack. */
+    SendTerminal(sessionID: string, input: RecordingTerminalInput): Promise<boolean>;
+}
+export interface FetchRecordingTransportConfig {
+    /** MJAPI base URL without a trailing slash (see {@link RecordingBaseURLFromGraphQLURL}). */
+    BaseURL: string;
+    /** Called per request so a refreshed token is picked up. */
+    Headers: () => Record<string, string>;
+    /** Defaults to `globalThis.fetch`, resolved at call time so tests can inject one. */
+    Fetch?: typeof fetch;
+}
+/**
+ * Derives the REST base from the GraphQL endpoint URL by dropping trailing slashes and `/graphql`.
+ * A scan, not a regex: `/\/+$/` backtracks quadratically on a long run of slashes that does not end
+ * the string, and the URL comes from host configuration.
+ */
+export declare function RecordingBaseURLFromGraphQLURL(url: string): string;
+export declare class FetchRecordingTransport implements IRecordingTransport {
+    private readonly config;
+    constructor(config: FetchRecordingTransportConfig);
+    UploadShard(sessionID: string, shard: RecordingShard | PendingRecordingShard, options?: RecordingUploadOptions): Promise<RecordingUploadOutcome>;
+    SendTerminal(sessionID: string, input: RecordingTerminalInput): Promise<boolean>;
+    private post;
+}
+//# sourceMappingURL=RecordingTransport.d.ts.map

package/dist/session/RecordingTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordingTransport.d.ts","sourceRoot":"","sources":["../../src/session/RecordingTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACnC,kFAAkF;IAClF,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AASnE,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAChC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,qBAAqB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACjJ,4FAA4F;IAC5F,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;AAED,MAAM,WAAW,6BAA6B;IAC1C,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAQD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED,qBAAa,uBAAwB,YAAW,mBAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,6BAA6B;IAE3D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,qBAAqB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK1I,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;YAO/E,IAAI;CAqBrB"}

package/dist/session/RecordingTransport.js

@@ -0,0 +1,61 @@
+/**
+ * Statuses that mean the server will never accept this shard, whoever sends it and however often.
+ * 401 is not here (a refreshed token can still send it), nor 404: an MJAPI older than the recording
+ * routes answers 404 to every shard, and a browser upgraded first must keep its audio for the server.
+ */
+const PERMANENT_REFUSAL_STATUSES = new Set([400, 403, 409, 410, 413]);
+function describeFailure(failure) {
+    return failure instanceof Error ? failure.message : String(failure);
+}
+const GRAPHQL_SUFFIX = '/graphql';
+/**
+ * Derives the REST base from the GraphQL endpoint URL by dropping trailing slashes and `/graphql`.
+ * A scan, not a regex: `/\/+$/` backtracks quadratically on a long run of slashes that does not end
+ * the string, and the URL comes from host configuration.
+ */
+export function RecordingBaseURLFromGraphQLURL(url) {
+    let end = url.length;
+    while (end > 0 && url.charCodeAt(end - 1) === 47 /* '/' */) {
+        end--;
+    }
+    const trimmed = url.slice(0, end);
+    return trimmed.endsWith(GRAPHQL_SUFFIX) ? trimmed.slice(0, -GRAPHQL_SUFFIX.length) : trimmed;
+}
+export class FetchRecordingTransport {
+    constructor(config) {
+        this.config = config;
+    }
+    UploadShard(sessionID, shard, options) {
+        const url = `${this.config.BaseURL}/realtime/recording/${encodeURIComponent(sessionID)}/shard/${shard.Index}`;
+        return this.post(url, shard.Bytes, options?.Keepalive === true, `shard ${sessionID}/${shard.Index}`);
+    }
+    async SendTerminal(sessionID, input) {
+        const final = input.Final === false ? '&final=false' : '';
+        const query = `lastShardIndex=${input.LastShardIndex}&capturedSamples=${input.CapturedSamples}${final}`;
+        const url = `${this.config.BaseURL}/realtime/recording/${encodeURIComponent(sessionID)}/end?${query}`;
+        return (await this.post(url, input.Tail ?? new Uint8Array(0), true, `terminal ${sessionID}/${input.LastShardIndex}`)) === 'Acked';
+    }
+    async post(url, body, keepalive, context) {
+        const doFetch = this.config.Fetch ?? globalThis.fetch;
+        try {
+            const response = await doFetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/octet-stream', ...this.config.Headers() },
+                // TS types a bare Uint8Array as possibly SharedArrayBuffer-backed; shard bytes never are.
+                body: body,
+                ...(keepalive ? { keepalive: true } : {}),
+            });
+            if (!response.ok) {
+                const outcome = PERMANENT_REFUSAL_STATUSES.has(response.status) ? 'Refused' : 'Retry';
+                console.warn(`[RealtimeSession] Recording ${context} rejected by server with status ${response.status} (${outcome === 'Refused' ? 'will not be re-sent' : 'will be retried'})`);
+                return outcome;
+            }
+            return 'Acked';
+        }
+        catch (failure) {
+            console.warn(`[RealtimeSession] Recording ${context} request failed: ${describeFailure(failure)}`, failure);
+            return 'Retry';
+        }
+    }
+}
+//# sourceMappingURL=RecordingTransport.js.map

package/dist/session/RecordingTransport.js.map

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

package/dist/session/app-client-tool-registry.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview The **owner-keyed registry of app client tools** a host registers with a realtime
+ * session (the tools the `ContextTool` proxy can run in the browser).
+ *
+ * The first version of this registry had one operation: *replace everything*. That is a trap the
+ * moment a host has two sources of tools. Explorer has two — a set of always-available globals
+ * (navigate, open a record, set the theme) and the tools of whichever surface the user is looking
+ * at — and registering the surface's tools replaced the globals unless the caller remembered to
+ * merge them back, and left the *previous* surface's tools registered if it forgot to clear them
+ * (the stale-tools-after-app-switch bug).
+ *
+ * The fix is ownership. Each source registers under an **owner key** and a registration replaces
+ * **only that owner's set**:
+ *
+ * ```
+ * Register('explorer.global',  [NavigateToApp, NavigateToRecord, …])   // once
+ * Register('explorer.surface', [SetFilter, …])                          // on every surface change
+ * Register('explorer.surface', [])                                      // surface gone → ONLY its tools go
+ * ```
+ *
+ * When two owners register a tool with the same name, the **later-registered owner wins** (an
+ * owner keeps its slot when it re-registers, so precedence does not flip every time a surface
+ * refreshes) — the more specific source is registered after the more general one.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import type { ClientToolMetadata } from '@memberjunction/ai-core-plus';
+/** Runs a client tool in the browser and returns its result (may be sync or async). */
+export type RealtimeAppClientToolHandler = (params: Record<string, unknown>) => Promise<unknown> | unknown;
+/**
+ * One tool a host registers. Only `Name` and `Handler` are required; the optional metadata makes the
+ * tool describable (in "available tools" error messages and the resolved capability set) without the
+ * host publishing a separate manifest.
+ */
+export interface AppClientToolRegistration {
+    /** The tool name the model calls (matched case-insensitively). */
+    Name: string;
+    /** Executes the tool. */
+    Handler: RealtimeAppClientToolHandler;
+    /** What the tool does, for the model. */
+    Description?: string;
+    /** JSON Schema of the tool's parameters. */
+    InputSchema?: Record<string, unknown>;
+    /** Grouping label. */
+    Category?: string;
+}
+/** The owner key used by the single-argument `RegisterAppClientTools(tools)` form. */
+export declare const DEFAULT_APP_TOOL_OWNER = "default";
+/** Owner-keyed registry; see the module documentation. */
+export declare class AppClientToolRegistry {
+    /** Owner → (lower-cased tool name → registration). Map insertion order = owner precedence (later wins). */
+    private readonly owners;
+    /**
+     * Replaces the tool set of ONE owner; every other owner's tools are untouched. Invalid entries
+     * (no name, no handler) are skipped. An empty list clears the owner's tools (it keeps its place in the
+     * precedence order; {@link Unregister} gives the place up too).
+     *
+     * @param owner A stable key naming the source (`'explorer.surface'`). Blank → {@link DEFAULT_APP_TOOL_OWNER}.
+     * @param tools The owner's complete current set.
+     */
+    Register(owner: string, tools: ReadonlyArray<AppClientToolRegistration>): void;
+    /** Removes one owner's tools (no-op when it has none). */
+    Unregister(owner: string): void;
+    /** Removes every owner's tools. */
+    Clear(): void;
+    /** Finds a tool by name (case-insensitive); on a collision the later-registered owner wins. */
+    Find(name: string): AppClientToolRegistration | undefined;
+    /** The distinct registered tool names, in registration form. */
+    Names(): string[];
+    /**
+     * The registered tools as {@link ClientToolMetadata} — the *session tier* of `ResolveClientTools`.
+     * Ordered later-owner-first, so the resolver's first-match-wins agrees with {@link Find}.
+     */
+    ToMetadata(): ClientToolMetadata[];
+}
+//# sourceMappingURL=app-client-tool-registry.d.ts.map

package/dist/session/app-client-tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-client-tool-registry.d.ts","sourceRoot":"","sources":["../../src/session/app-client-tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,uFAAuF;AACvF,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE3G;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACtC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,4BAA4B,CAAC;IACtC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,0DAA0D;AAC1D,qBAAa,qBAAqB;IAC9B,2GAA2G;IAC3G,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6D;IAEpF;;;;;;;OAOG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,yBAAyB,CAAC,GAAG,IAAI;IAarF,0DAA0D;IACnD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC,mCAAmC;IAC5B,KAAK,IAAI,IAAI;IAIpB,+FAA+F;IACxF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS;IAShE,gEAAgE;IACzD,KAAK,IAAI,MAAM,EAAE;IAUxB;;;OAGG;IACI,UAAU,IAAI,kBAAkB,EAAE;CAW5C"}

package/dist/session/app-client-tool-registry.js

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview The **owner-keyed registry of app client tools** a host registers with a realtime
+ * session (the tools the `ContextTool` proxy can run in the browser).
+ *
+ * The first version of this registry had one operation: *replace everything*. That is a trap the
+ * moment a host has two sources of tools. Explorer has two — a set of always-available globals
+ * (navigate, open a record, set the theme) and the tools of whichever surface the user is looking
+ * at — and registering the surface's tools replaced the globals unless the caller remembered to
+ * merge them back, and left the *previous* surface's tools registered if it forgot to clear them
+ * (the stale-tools-after-app-switch bug).
+ *
+ * The fix is ownership. Each source registers under an **owner key** and a registration replaces
+ * **only that owner's set**:
+ *
+ * ```
+ * Register('explorer.global',  [NavigateToApp, NavigateToRecord, …])   // once
+ * Register('explorer.surface', [SetFilter, …])                          // on every surface change
+ * Register('explorer.surface', [])                                      // surface gone → ONLY its tools go
+ * ```
+ *
+ * When two owners register a tool with the same name, the **later-registered owner wins** (an
+ * owner keeps its slot when it re-registers, so precedence does not flip every time a surface
+ * refreshes) — the more specific source is registered after the more general one.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+/** The owner key used by the single-argument `RegisterAppClientTools(tools)` form. */
+export const DEFAULT_APP_TOOL_OWNER = 'default';
+/** Owner-keyed registry; see the module documentation. */
+export class AppClientToolRegistry {
+    constructor() {
+        /** Owner → (lower-cased tool name → registration). Map insertion order = owner precedence (later wins). */
+        this.owners = new Map();
+    }
+    /**
+     * Replaces the tool set of ONE owner; every other owner's tools are untouched. Invalid entries
+     * (no name, no handler) are skipped. An empty list clears the owner's tools (it keeps its place in the
+     * precedence order; {@link Unregister} gives the place up too).
+     *
+     * @param owner A stable key naming the source (`'explorer.surface'`). Blank → {@link DEFAULT_APP_TOOL_OWNER}.
+     * @param tools The owner's complete current set.
+     */
+    Register(owner, tools) {
+        const key = normalizeOwner(owner);
+        const set = new Map();
+        for (const tool of tools) {
+            if (tool?.Name?.trim() && typeof tool.Handler === 'function') {
+                set.set(tool.Name.trim().toLowerCase(), tool);
+            }
+        }
+        // Map#set on an existing key keeps its insertion slot, so an owner that re-registers (even with
+        // an empty set) keeps its place in the precedence order; only Unregister() gives the slot up.
+        this.owners.set(key, set);
+    }
+    /** Removes one owner's tools (no-op when it has none). */
+    Unregister(owner) {
+        this.owners.delete(normalizeOwner(owner));
+    }
+    /** Removes every owner's tools. */
+    Clear() {
+        this.owners.clear();
+    }
+    /** Finds a tool by name (case-insensitive); on a collision the later-registered owner wins. */
+    Find(name) {
+        const wanted = (name ?? '').trim().toLowerCase();
+        let found;
+        for (const set of this.owners.values()) {
+            found = set.get(wanted) ?? found;
+        }
+        return found;
+    }
+    /** The distinct registered tool names, in registration form. */
+    Names() {
+        const names = new Map();
+        for (const set of this.owners.values()) {
+            for (const [lower, tool] of set) {
+                names.set(lower, tool.Name);
+            }
+        }
+        return [...names.values()];
+    }
+    /**
+     * The registered tools as {@link ClientToolMetadata} — the *session tier* of `ResolveClientTools`.
+     * Ordered later-owner-first, so the resolver's first-match-wins agrees with {@link Find}.
+     */
+    ToMetadata() {
+        const ordered = [...this.owners.values()].reverse();
+        return ordered.flatMap((set) => [...set.values()].map((tool) => ({
+            Name: tool.Name,
+            Description: tool.Description ?? '',
+            InputSchema: tool.InputSchema ?? {},
+            Category: tool.Category,
+        })));
+    }
+}
+/** Normalizes an owner key; blank falls back to the default owner. */
+function normalizeOwner(owner) {
+    return owner?.trim() ? owner.trim() : DEFAULT_APP_TOOL_OWNER;
+}
+//# sourceMappingURL=app-client-tool-registry.js.map

package/dist/session/app-client-tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-client-tool-registry.js","sourceRoot":"","sources":["../../src/session/app-client-tool-registry.ts"],"names":[],"mappings":"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"}

package/dist/session/avatar-notice.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Whether a connected call tells the user it shows no avatar, and why.
+ *
+ * The server decides the reasons it can see at mint (the model renders no avatar, the persona has no face for it, a
+ * custom avatar, an app that said at mint it shows no agent video: `host`) and returns them as the session's avatar
+ * status. Two more show only in the browser, once the call is connected: the app asked for no agent video (`host`), or
+ * it asked and the browser could not play it (`browser`). {@link ResolveAvatarNotice} puts the three facts together; the
+ * runtime publishes the result once per call.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import type { ClientRealtimeSessionConfig, ParsedRealtimeAvatarStatus, RealtimeAvatarUnavailableReason } from '@memberjunction/ai';
+/** Why a call shows no avatar, told once after it connects. A host turns the reason into words. */
+export interface RealtimeAvatarNotice {
+    /**
+     * Why the call is audio only. Absent when the mint gave a reason this version doesn't know, such as a newer server's:
+     * the avatar was asked for and isn't shown, and a host says so without a reason.
+     */
+    readonly Reason?: RealtimeAvatarUnavailableReason;
+}
+/**
+ * Whether a connected call should say it shows no avatar, and why.
+ *
+ * - No status, or the session asked for no avatar: nothing to say.
+ * - Asked for and not granted: the status's reason; a notice without one when the reason is one this version doesn't
+ *   know (`ReasonUnknown`); nothing when the status gives no reason.
+ * - Granted, but the app asked for no agent video: `host`.
+ * - Granted and asked for, but the agent's video track is not live: `browser`.
+ * - Granted, asked for and live: nothing to say; the avatar shows.
+ *
+ * @param status The mint's avatar status as `ParseRealtimeAvatarStatus` reads it, or `null` when the mint reported none.
+ * @param requested Whether the session asked for the agent's video (an outbound video track).
+ * @param established Whether the agent's video track is live once connected.
+ * @returns The notice, or `null` when there is nothing to say.
+ */
+export declare function ResolveAvatarNotice(status: ParsedRealtimeAvatarStatus | null, requested: boolean, established: boolean): RealtimeAvatarNotice | null;
+/**
+ * Whether a client config asks for the agent's video: an outbound video track among the tracks the session requests.
+ *
+ * @param config The config the session connected with.
+ */
+export declare function RequestsAgentVideo(config: ClientRealtimeSessionConfig): boolean;
+//# sourceMappingURL=avatar-notice.d.ts.map

package/dist/session/avatar-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-notice.d.ts","sourceRoot":"","sources":["../../src/session/avatar-notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAa,0BAA0B,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAG9I,mGAAmG;AACnG,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,+BAA+B,CAAC;CACnD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAcpJ;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAG/E"}

package/dist/session/avatar-notice.js

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Whether a connected call tells the user it shows no avatar, and why.
+ *
+ * The server decides the reasons it can see at mint (the model renders no avatar, the persona has no face for it, a
+ * custom avatar, an app that said at mint it shows no agent video: `host`) and returns them as the session's avatar
+ * status. Two more show only in the browser, once the call is connected: the app asked for no agent video (`host`), or
+ * it asked and the browser could not play it (`browser`). {@link ResolveAvatarNotice} puts the three facts together; the
+ * runtime publishes the result once per call.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { REQUESTED_TRACKS_SESSION_KEY } from '@memberjunction/ai-realtime-client';
+/**
+ * Whether a connected call should say it shows no avatar, and why.
+ *
+ * - No status, or the session asked for no avatar: nothing to say.
+ * - Asked for and not granted: the status's reason; a notice without one when the reason is one this version doesn't
+ *   know (`ReasonUnknown`); nothing when the status gives no reason.
+ * - Granted, but the app asked for no agent video: `host`.
+ * - Granted and asked for, but the agent's video track is not live: `browser`.
+ * - Granted, asked for and live: nothing to say; the avatar shows.
+ *
+ * @param status The mint's avatar status as `ParseRealtimeAvatarStatus` reads it, or `null` when the mint reported none.
+ * @param requested Whether the session asked for the agent's video (an outbound video track).
+ * @param established Whether the agent's video track is live once connected.
+ * @returns The notice, or `null` when there is nothing to say.
+ */
+export function ResolveAvatarNotice(status, requested, established) {
+    if (!status?.Requested) {
+        return null;
+    }
+    if (!status.Granted) {
+        if (status.Reason) {
+            return { Reason: status.Reason };
+        }
+        return status.ReasonUnknown ? {} : null;
+    }
+    if (!requested) {
+        return { Reason: 'host' };
+    }
+    return established ? null : { Reason: 'browser' };
+}
+/**
+ * Whether a client config asks for the agent's video: an outbound video track among the tracks the session requests.
+ *
+ * @param config The config the session connected with.
+ */
+export function RequestsAgentVideo(config) {
+    const tracks = config.SessionConfig[REQUESTED_TRACKS_SESSION_KEY];
+    return Array.isArray(tracks) && tracks.some(isAgentVideoTrack);
+}
+/** Whether a requested-track entry is the agent's video: outbound, video. */
+function isAgentVideoTrack(raw) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        return false;
+    }
+    const modality = raw['Modality'];
+    return raw['Direction'] === 'outbound' && typeof modality === 'string' && modality.trim().toLowerCase() === 'video';
+}
+//# sourceMappingURL=avatar-notice.js.map

package/dist/session/avatar-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-notice.js","sourceRoot":"","sources":["../../src/session/avatar-notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAWlF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyC,EAAE,SAAkB,EAAE,WAAoB;IACrH,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmC;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACjE,CAAC;AAED,6EAA6E;AAC7E,SAAS,iBAAiB,CAAC,GAAc;IACvC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,UAAU,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC;AACtH,CAAC"}

package/dist/session/call-end.d.ts

@@ -0,0 +1,21 @@
+import { type RealtimeClientError } from '@memberjunction/ai-realtime-client';
+/** How a host words why a call ended: a short status label, and a sentence for a screen or a notice. */
+export interface RealtimeCallEndDescription {
+    /** A short status label, such as a call bar's state chip shows. */
+    Label: string;
+    /** A sentence saying what happened and what to do next. */
+    Message: string;
+}
+/**
+ * What a call says when it ended because its session reached its time limit (MJAPI's relay ends a relayed call at
+ * 30 minutes, or sooner when the session has a shorter cap), in place of a connection error.
+ */
+export declare const REALTIME_CALL_TIME_LIMIT_END: Readonly<RealtimeCallEndDescription>;
+/**
+ * Why a call ended, in words a host can show, when the call's client said why (`RealtimeSessionRuntime.LastSessionError`);
+ * `null` when it ended for a reason with no words of its own, such as a dropped connection, which a host words itself.
+ *
+ * @param error The call's fatal client error, or `null` when it reported none.
+ */
+export declare function DescribeCallEnd(error: RealtimeClientError | null): Readonly<RealtimeCallEndDescription> | null;
+//# sourceMappingURL=call-end.d.ts.map

package/dist/session/call-end.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-end.d.ts","sourceRoot":"","sources":["../../src/session/call-end.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAErH,wGAAwG;AACxG,MAAM,WAAW,0BAA0B;IACvC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,0BAA0B,CAG5E,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,GAAG,QAAQ,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAE9G"}

package/dist/session/call-end.js

@@ -0,0 +1,19 @@
+import { REALTIME_CLIENT_TIME_LIMIT_ERROR_CODE } from '@memberjunction/ai-realtime-client';
+/**
+ * What a call says when it ended because its session reached its time limit (MJAPI's relay ends a relayed call at
+ * 30 minutes, or sooner when the session has a shorter cap), in place of a connection error.
+ */
+export const REALTIME_CALL_TIME_LIMIT_END = Object.freeze({
+    Label: 'Time limit reached',
+    Message: 'This call reached its time limit. Start a new call to keep talking.',
+});
+/**
+ * Why a call ended, in words a host can show, when the call's client said why (`RealtimeSessionRuntime.LastSessionError`);
+ * `null` when it ended for a reason with no words of its own, such as a dropped connection, which a host words itself.
+ *
+ * @param error The call's fatal client error, or `null` when it reported none.
+ */
+export function DescribeCallEnd(error) {
+    return error?.Code === REALTIME_CLIENT_TIME_LIMIT_ERROR_CODE ? REALTIME_CALL_TIME_LIMIT_END : null;
+}
+//# sourceMappingURL=call-end.js.map

package/dist/session/call-end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-end.js","sourceRoot":"","sources":["../../src/session/call-end.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAA4B,MAAM,oCAAoC,CAAC;AAUrH;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAyC,MAAM,CAAC,MAAM,CAAC;IAC5F,KAAK,EAAE,oBAAoB;IAC3B,OAAO,EAAE,qEAAqE;CACjF,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiC;IAC7D,OAAO,KAAK,EAAE,IAAI,KAAK,qCAAqC,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,IAAI,CAAC;AACvG,CAAC"}