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

package/dist/session/channel-exposure-preferences.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview The user's own choice of how much of each channel the agent may perceive.
+ *
+ * Exposure policy has four layers (see `ResolveChannelExposure` in `@memberjunction/ai-core-plus`); the
+ * fourth is the USER's, set from the "agent can see" control in the realtime overlay and remembered per
+ * channel key so a person who turned the agent's view of their whiteboard off does not have to do it
+ * again next call.
+ *
+ * Where it is remembered is the host's business, which is why this is an interface: the runtime is
+ * framework-neutral and does not know whether the person is signed in. Signed-in hosts back it with the
+ * user's persisted settings (`mj.realtime.visualPerception.v1`, via `UserInfoEngine`); an anonymous
+ * principal or a connect-only embed has no settings to write to and uses the in-memory store, so the
+ * choice lasts for the page and no longer.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { type RealtimeChannelExposure } from '@memberjunction/ai-core-plus';
+/**
+ * The `UserInfoEngine` setting key the choices are persisted under, per user. The `v1` is the shape of
+ * the stored JSON ({@link SerializeExposurePreferences}); bump it if that shape ever changes so old
+ * values can be read and migrated rather than misread.
+ */
+export declare const VISUAL_PERCEPTION_SETTING_KEY = "mj.realtime.visualPerception.v1";
+/** Where the user's per-channel exposure choices are kept. */
+export interface IChannelExposurePreferences {
+    /** The user's choice for a channel (key matched case-insensitively), or `undefined` when they made none. */
+    Get(channelKey: string): RealtimeChannelExposure | undefined;
+    /** Records the user's choice for a channel. `undefined` clears it (back to "no choice"). */
+    Set(channelKey: string, level: RealtimeChannelExposure | undefined): void;
+}
+/**
+ * Reads persisted choices tolerantly: a hand-edited or corrupt value contributes nothing (never throws), and
+ * only valid levels survive. Keys come back normalized.
+ *
+ * @param json The stored setting value, or `undefined`/`null`/blank when there is none.
+ */
+export declare function ParseExposurePreferences(json: string | null | undefined): Map<string, RealtimeChannelExposure>;
+/**
+ * Serializes choices for persistence. Only the choices themselves are stored (`{"whiteboard":"state"}`):
+ * a channel the user never touched has no entry, so a later change to a channel's default is not
+ * frozen in by an old write.
+ */
+export declare function SerializeExposurePreferences(preferences: ReadonlyMap<string, RealtimeChannelExposure>): string;
+/** The default store: choices last for this object's lifetime only. */
+export declare class InMemoryChannelExposurePreferences implements IChannelExposurePreferences {
+    private readonly values;
+    Get(channelKey: string): RealtimeChannelExposure | undefined;
+    Set(channelKey: string, level: RealtimeChannelExposure | undefined): void;
+}
+/**
+ * The default store: persisted in the signed-in user's settings (`MJ: User Settings`, key
+ * {@link VISUAL_PERCEPTION_SETTING_KEY}) via `UserInfoEngine`, so the choice follows the person across
+ * devices; kept in memory when there is no user to persist for (an anonymous principal, a connect-only embed).
+ *
+ * Writes always go to memory first, so a choice takes effect and is read back even if persisting it
+ * fails or is not possible. Reads prefer the persisted value when persistence is available, since
+ * `UserInfoEngine.GetSetting` is a synchronous cache hit that already reflects a pending debounced write.
+ */
+export declare class UserSettingsExposurePreferences implements IChannelExposurePreferences {
+    private readonly canPersist;
+    private readonly memory;
+    private warnedAboutRead;
+    /** @param canPersist Whether user settings can be read and written right now (a signed-in user on a metadata-bearing provider). */
+    constructor(canPersist: () => boolean);
+    Get(channelKey: string): RealtimeChannelExposure | undefined;
+    Set(channelKey: string, level: RealtimeChannelExposure | undefined): void;
+    /** The persisted choices; empty (and logged once) when the settings cache cannot be read. */
+    private readPersisted;
+}
+//# sourceMappingURL=channel-exposure-preferences.d.ts.map

package/dist/session/channel-exposure-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-exposure-preferences.d.ts","sourceRoot":"","sources":["../../src/session/channel-exposure-preferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAwC,KAAK,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAElH;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,oCAAoC,CAAC;AAE/E,8DAA8D;AAC9D,MAAM,WAAW,2BAA2B;IAC1C,4GAA4G;IAC5G,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAAC;IAC7D,4FAA4F;IAC5F,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAAC;CAC3E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAqB9G;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAAG,MAAM,CAS9G;AAED,uEAAuE;AACvE,qBAAa,kCAAmC,YAAW,2BAA2B;IACpF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IAE9D,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAI5D,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI;CAQjF;AAED;;;;;;;;GAQG;AACH,qBAAa,+BAAgC,YAAW,2BAA2B;IAKrE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IACnE,OAAO,CAAC,eAAe,CAAS;IAEhC,mIAAmI;gBACtG,UAAU,EAAE,MAAM,OAAO;IAE/C,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAO5D,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI;IAehF,6FAA6F;IAC7F,OAAO,CAAC,aAAa;CAWtB"}

package/dist/session/channel-exposure-preferences.js

@@ -0,0 +1,138 @@
+/**
+ * @fileoverview The user's own choice of how much of each channel the agent may perceive.
+ *
+ * Exposure policy has four layers (see `ResolveChannelExposure` in `@memberjunction/ai-core-plus`); the
+ * fourth is the USER's, set from the "agent can see" control in the realtime overlay and remembered per
+ * channel key so a person who turned the agent's view of their whiteboard off does not have to do it
+ * again next call.
+ *
+ * Where it is remembered is the host's business, which is why this is an interface: the runtime is
+ * framework-neutral and does not know whether the person is signed in. Signed-in hosts back it with the
+ * user's persisted settings (`mj.realtime.visualPerception.v1`, via `UserInfoEngine`); an anonymous
+ * principal or a connect-only embed has no settings to write to and uses the in-memory store, so the
+ * choice lasts for the page and no longer.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { UserInfoEngine } from '@memberjunction/core-entities';
+import { IsExposureLevel, NormalizeChannelKey } from '@memberjunction/ai-core-plus';
+/**
+ * The `UserInfoEngine` setting key the choices are persisted under, per user. The `v1` is the shape of
+ * the stored JSON ({@link SerializeExposurePreferences}); bump it if that shape ever changes so old
+ * values can be read and migrated rather than misread.
+ */
+export const VISUAL_PERCEPTION_SETTING_KEY = 'mj.realtime.visualPerception.v1';
+/**
+ * Reads persisted choices tolerantly: a hand-edited or corrupt value contributes nothing (never throws), and
+ * only valid levels survive. Keys come back normalized.
+ *
+ * @param json The stored setting value, or `undefined`/`null`/blank when there is none.
+ */
+export function ParseExposurePreferences(json) {
+    const result = new Map();
+    if (typeof json !== 'string' || json.trim().length === 0) {
+        return result;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        return result;
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return result;
+    }
+    for (const [key, value] of Object.entries(parsed)) {
+        const id = NormalizeChannelKey(key);
+        if (id.length > 0 && IsExposureLevel(value)) {
+            result.set(id, value);
+        }
+    }
+    return result;
+}
+/**
+ * Serializes choices for persistence. Only the choices themselves are stored (`{"whiteboard":"state"}`):
+ * a channel the user never touched has no entry, so a later change to a channel's default is not
+ * frozen in by an old write.
+ */
+export function SerializeExposurePreferences(preferences) {
+    const record = {};
+    for (const [key, level] of preferences) {
+        if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
+            continue;
+        }
+        record[key] = level;
+    }
+    return JSON.stringify(record);
+}
+/** The default store: choices last for this object's lifetime only. */
+export class InMemoryChannelExposurePreferences {
+    constructor() {
+        this.values = new Map();
+    }
+    Get(channelKey) {
+        return this.values.get(NormalizeChannelKey(channelKey));
+    }
+    Set(channelKey, level) {
+        const id = NormalizeChannelKey(channelKey);
+        if (level === undefined) {
+            this.values.delete(id);
+        }
+        else {
+            this.values.set(id, level);
+        }
+    }
+}
+/**
+ * The default store: persisted in the signed-in user's settings (`MJ: User Settings`, key
+ * {@link VISUAL_PERCEPTION_SETTING_KEY}) via `UserInfoEngine`, so the choice follows the person across
+ * devices; kept in memory when there is no user to persist for (an anonymous principal, a connect-only embed).
+ *
+ * Writes always go to memory first, so a choice takes effect and is read back even if persisting it
+ * fails or is not possible. Reads prefer the persisted value when persistence is available, since
+ * `UserInfoEngine.GetSetting` is a synchronous cache hit that already reflects a pending debounced write.
+ */
+export class UserSettingsExposurePreferences {
+    /** @param canPersist Whether user settings can be read and written right now (a signed-in user on a metadata-bearing provider). */
+    constructor(canPersist) {
+        this.canPersist = canPersist;
+        this.memory = new InMemoryChannelExposurePreferences();
+        this.warnedAboutRead = false;
+    }
+    Get(channelKey) {
+        if (!this.canPersist()) {
+            return this.memory.Get(channelKey);
+        }
+        return this.readPersisted().get(NormalizeChannelKey(channelKey)) ?? this.memory.Get(channelKey);
+    }
+    Set(channelKey, level) {
+        this.memory.Set(channelKey, level);
+        if (!this.canPersist()) {
+            return;
+        }
+        const persisted = this.readPersisted();
+        const id = NormalizeChannelKey(channelKey);
+        if (level === undefined) {
+            persisted.delete(id);
+        }
+        else {
+            persisted.set(id, level);
+        }
+        UserInfoEngine.Instance.SetSettingDebounced(VISUAL_PERCEPTION_SETTING_KEY, SerializeExposurePreferences(persisted));
+    }
+    /** The persisted choices; empty (and logged once) when the settings cache cannot be read. */
+    readPersisted() {
+        try {
+            return ParseExposurePreferences(UserInfoEngine.Instance.GetSetting(VISUAL_PERCEPTION_SETTING_KEY));
+        }
+        catch (error) {
+            if (!this.warnedAboutRead) {
+                this.warnedAboutRead = true;
+                console.warn('[RealtimeSession] Could not read the saved visual-perception choices; using this page\'s choices only:', error);
+            }
+            return new Map();
+        }
+    }
+}
+//# sourceMappingURL=channel-exposure-preferences.js.map

package/dist/session/channel-exposure-preferences.js.map

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

package/dist/session/channel-session-scope.d.ts

@@ -0,0 +1,142 @@
+/**
+ * @fileoverview The **session-scoping helpers** of the realtime runtime — turning the channel plugins
+ * a session *could* have into the channels it *does* have.
+ *
+ * The decision itself (`ResolveRealtimeChannelScope`) is pure and lives in `@memberjunction/ai-core-plus`
+ * so the server and the browser make it identically. What lives here is the browser-side plumbing around it:
+ *
+ * - {@link PreparedChannel} — a plugin that has been *resolved* (from the registry or declared by the
+ *   host) but not yet *initialized*. Preparing is side-effect free, which is what lets the runtime
+ *   report candidates to the server at mint without having started anything the server may then veto.
+ * - {@link BuildChannelCandidate} / {@link ResolveLocalChannelScope} — the facts the browser reports,
+ *   and the scope it resolves on its own when no server policy comes back (a legacy server, or a host
+ *   that mints through its own proxy).
+ * - {@link ReconcileChannelsWithPolicy} — maps a resolved policy back onto the prepared plugins.
+ * - {@link MergeToolMetadata} — layers a host's registered tool handlers over the manifest the host
+ *   streamed, so "available tools" messages can describe them.
+ *
+ * Framework-free and DOM-free: importable in plain Node tests.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import type { JSONObject, RealtimeToolDefinition } from '@memberjunction/ai';
+import { type ClientToolMetadata, type RealtimeChannelCandidate, type RealtimeChannelDescriptor, type RealtimeChannelDisplayPolicy, type RealtimeChannelRegistryState, type RealtimeChannelScopeResult, type ResolvedRealtimeChannel } from '@memberjunction/ai-core-plus';
+import type { BaseRealtimeChannelClient } from '../channels/base-realtime-channel-client.js';
+/**
+ * A channel the HOST brings to a session — the way a page or app adds a channel that has no
+ * `MJ: AI Agent Channels` row, which is the ONLY way a connect-only (anonymous embed) session
+ * gets channels, because that kind of session has no entity metadata to read the registry from.
+ *
+ * Supply either {@link ClientPluginClass} (a ClassFactory key, exactly like a registry row's
+ * `ClientPluginClass`) or {@link Create} (a factory — for a channel the host constructs itself, e.g.
+ * with injected collaborators). If both are given, {@link Create} wins.
+ *
+ * A host *adds* channels and supplies *defaults*; it cannot lift an agent or app `exclude`, and its
+ * `Config` / `DisplayPolicy` are overridden by the agent/app layers. An inactive registry row for the
+ * same channel still switches it off.
+ */
+export interface RealtimeHostChannelDeclaration {
+    /** ClassFactory key of the channel plugin (`@RegisterClass(BaseRealtimeChannelClient, '<key>')`). */
+    ClientPluginClass?: string;
+    /** Factory that builds the plugin; use when the host constructs it with its own collaborators. */
+    Create?: () => BaseRealtimeChannelClient;
+    /** Default per-channel configuration; agent/app `channels.config` overrides it. */
+    Config?: JSONObject;
+    /** Default display for this host; agent/app `channels.displayPolicy` overrides it. */
+    DisplayPolicy?: RealtimeChannelDisplayPolicy;
+}
+/**
+ * Per-start options of {@link RealtimeSessionRuntime.StartRealtimeSession} that are not part of the
+ * mint contract. Every field is optional; omit the whole object for the behavior hosts always had.
+ */
+export interface RealtimeSessionStartOptions {
+    /** Channels the host brings to this session (see {@link RealtimeHostChannelDeclaration}). */
+    HostChannels?: RealtimeHostChannelDeclaration[];
+    /** The fork (`MJ: Conversation Branches.ID`) the session starts on; omitted or null is Main. */
+    ConversationBranchID?: string | null;
+    /**
+     * Have the user check the camera before the agent sees it. The call's first camera start opens the camera for the
+     * user only: the camera's state is `starting` with `Checking` set and the stream to preview, and nothing reaches the
+     * agent until the host calls `ConfirmCamera`. Later starts in the same call skip the check. Set it only when the host
+     * shows the check; otherwise the camera waits for a confirmation that never comes.
+     */
+    CameraCheck?: boolean;
+}
+/** A resolved-but-not-yet-initialized channel plugin, with what the scope decision needs to know about it. */
+export interface PreparedChannel {
+    /** The plugin instance (constructed, NOT initialized). */
+    Plugin: BaseRealtimeChannelClient;
+    /** Its key (the plugin's `ChannelName`). */
+    Key: string;
+    /** Registry state: `'active'`, `'inactive'` (the kill switch), or `'none'` (host-declared only). */
+    Registry: RealtimeChannelRegistryState;
+    /** The host declaration that brought it, when one did. */
+    HostDeclaration?: RealtimeHostChannelDeclaration;
+}
+/** Looks a prepared channel up by key, case-insensitively. */
+export declare function FindPreparedChannel(prepared: ReadonlyArray<PreparedChannel>, key: string): PreparedChannel | undefined;
+/**
+ * Whether a session with these prepared channels could show the agent's video: one of them shows it (it sinks outbound
+ * video, as the Avatar channel does) and is not switched off in the registry. A policy can only select among the
+ * prepared plugins, so with none the session never asks for the agent's video at connect, whatever the server scopes:
+ * the mint can then ask the model for no avatar (`showsAgentVideo: false`).
+ *
+ * @param prepared The channels prepared for the session.
+ */
+export declare function PreparedChannelsShowAgentVideo(prepared: ReadonlyArray<PreparedChannel>): boolean;
+/**
+ * The facts the browser reports about one channel at mint (also the input to the local scope
+ * decision). Reads the plugin's descriptor and tools; never initializes it.
+ *
+ * @param prepared The prepared channel.
+ * @param descriptor The plugin's descriptor (passed in so callers read it once).
+ */
+export declare function BuildChannelCandidate(prepared: PreparedChannel, descriptor: RealtimeChannelDescriptor): RealtimeChannelCandidate & {
+    Registry: RealtimeChannelRegistryState;
+};
+/**
+ * Resolves the scope from code defaults and host declarations alone — what the browser decides when
+ * no server policy arrives. Identical to the server's decision in the absence of an agent/app layer.
+ *
+ * @param candidates The reported candidates (with registry state).
+ */
+export declare function ResolveLocalChannelScope(candidates: ReadonlyArray<RealtimeChannelCandidate & {
+    Registry: RealtimeChannelRegistryState;
+}>): RealtimeChannelScopeResult;
+/** The tools of each candidate, keyed by channel key — the input `SelectNativeChannelTools` wants. */
+export declare function ToolsByChannelKey(candidates: ReadonlyArray<RealtimeChannelCandidate>): Map<string, ReadonlyArray<RealtimeToolDefinition>>;
+/** A policy channel paired with the prepared plugin it names. */
+export interface ReconciledChannel {
+    /** The prepared plugin. */
+    Prepared: PreparedChannel;
+    /** What the policy resolved for it. */
+    Resolved: ResolvedRealtimeChannel;
+}
+/** The outcome of {@link ReconcileChannelsWithPolicy}. */
+export interface ChannelReconciliation {
+    /** Channels the policy puts in the session, in policy order. */
+    InSession: ReconciledChannel[];
+    /** Prepared plugins the policy left out — never initialized; the runtime just drops them. */
+    Dropped: PreparedChannel[];
+    /** Policy channels the browser has no plugin for (a stale or foreign policy); logged by the caller. */
+    Unknown: string[];
+}
+/**
+ * Maps a resolved policy back onto the prepared plugins. A policy can only select among plugins the
+ * browser actually has — it can never conjure one — so a key with no plugin is reported, not honored.
+ *
+ * @param prepared Every prepared plugin.
+ * @param channels The policy's in-session channels.
+ */
+export declare function ReconcileChannelsWithPolicy(prepared: ReadonlyArray<PreparedChannel>, channels: ReadonlyArray<ResolvedRealtimeChannel>): ChannelReconciliation;
+/**
+ * Overlays the metadata of tools a host registered handlers for onto the manifest it streamed, by
+ * name (case-insensitive). A registered tool's own description/schema wins when it supplied one; a
+ * bare `{ Name, Handler }` registration (what most hosts do) inherits the manifest's description and
+ * schema instead of showing up with none.
+ *
+ * @param registered The registry's tools as metadata.
+ * @param manifest The tools the host's app-context snapshot advertises (may be empty).
+ */
+export declare function MergeToolMetadata(registered: ReadonlyArray<ClientToolMetadata>, manifest: ReadonlyArray<ClientToolMetadata>): ClientToolMetadata[];
+//# sourceMappingURL=channel-session-scope.d.ts.map

package/dist/session/channel-session-scope.d.ts.map

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

package/dist/session/channel-session-scope.js

@@ -0,0 +1,128 @@
+/**
+ * @fileoverview The **session-scoping helpers** of the realtime runtime — turning the channel plugins
+ * a session *could* have into the channels it *does* have.
+ *
+ * The decision itself (`ResolveRealtimeChannelScope`) is pure and lives in `@memberjunction/ai-core-plus`
+ * so the server and the browser make it identically. What lives here is the browser-side plumbing around it:
+ *
+ * - {@link PreparedChannel} — a plugin that has been *resolved* (from the registry or declared by the
+ *   host) but not yet *initialized*. Preparing is side-effect free, which is what lets the runtime
+ *   report candidates to the server at mint without having started anything the server may then veto.
+ * - {@link BuildChannelCandidate} / {@link ResolveLocalChannelScope} — the facts the browser reports,
+ *   and the scope it resolves on its own when no server policy comes back (a legacy server, or a host
+ *   that mints through its own proxy).
+ * - {@link ReconcileChannelsWithPolicy} — maps a resolved policy back onto the prepared plugins.
+ * - {@link MergeToolMetadata} — layers a host's registered tool handlers over the manifest the host
+ *   streamed, so "available tools" messages can describe them.
+ *
+ * Framework-free and DOM-free: importable in plain Node tests.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { NormalizeChannelKey, ResolveRealtimeChannelScope, } from '@memberjunction/ai-core-plus';
+/** Looks a prepared channel up by key, case-insensitively. */
+export function FindPreparedChannel(prepared, key) {
+    const id = NormalizeChannelKey(key);
+    return prepared.find((p) => NormalizeChannelKey(p.Key) === id);
+}
+/**
+ * Whether a session with these prepared channels could show the agent's video: one of them shows it (it sinks outbound
+ * video, as the Avatar channel does) and is not switched off in the registry. A policy can only select among the
+ * prepared plugins, so with none the session never asks for the agent's video at connect, whatever the server scopes:
+ * the mint can then ask the model for no avatar (`showsAgentVideo: false`).
+ *
+ * @param prepared The channels prepared for the session.
+ */
+export function PreparedChannelsShowAgentVideo(prepared) {
+    return prepared.some((p) => p.Registry !== 'inactive' && p.Plugin.ShowsAgentVideo);
+}
+/**
+ * The facts the browser reports about one channel at mint (also the input to the local scope
+ * decision). Reads the plugin's descriptor and tools; never initializes it.
+ *
+ * @param prepared The prepared channel.
+ * @param descriptor The plugin's descriptor (passed in so callers read it once).
+ */
+export function BuildChannelCandidate(prepared, descriptor) {
+    const candidate = {
+        Key: prepared.Key,
+        DefaultAvailability: descriptor.DefaultAvailability,
+        DisplayPolicy: descriptor.DisplayPolicy,
+        MaxExposure: descriptor.MaxExposure,
+        ToolNamePrefix: prepared.Plugin.ToolNamePrefix,
+        Tools: prepared.Plugin.GetToolDefinitions(),
+        Registry: prepared.Registry,
+    };
+    const declaration = prepared.HostDeclaration;
+    if (declaration) {
+        candidate.HostDeclared = true;
+        if (declaration.Config) {
+            candidate.HostConfig = declaration.Config;
+        }
+        if (declaration.DisplayPolicy) {
+            candidate.HostDisplayPolicy = declaration.DisplayPolicy;
+        }
+    }
+    return candidate;
+}
+/**
+ * Resolves the scope from code defaults and host declarations alone — what the browser decides when
+ * no server policy arrives. Identical to the server's decision in the absence of an agent/app layer.
+ *
+ * @param candidates The reported candidates (with registry state).
+ */
+export function ResolveLocalChannelScope(candidates) {
+    return ResolveRealtimeChannelScope({ Candidates: candidates.map((c) => ({ ...c })) });
+}
+/** The tools of each candidate, keyed by channel key — the input `SelectNativeChannelTools` wants. */
+export function ToolsByChannelKey(candidates) {
+    return new Map(candidates.map((c) => [c.Key, c.Tools]));
+}
+/**
+ * Maps a resolved policy back onto the prepared plugins. A policy can only select among plugins the
+ * browser actually has — it can never conjure one — so a key with no plugin is reported, not honored.
+ *
+ * @param prepared Every prepared plugin.
+ * @param channels The policy's in-session channels.
+ */
+export function ReconcileChannelsWithPolicy(prepared, channels) {
+    const inSession = [];
+    const unknown = [];
+    const used = new Set();
+    for (const resolved of channels) {
+        const match = FindPreparedChannel(prepared, resolved.Key);
+        if (match && !used.has(match)) {
+            used.add(match);
+            inSession.push({ Prepared: match, Resolved: resolved });
+        }
+        else if (!match) {
+            unknown.push(resolved.Key);
+        }
+    }
+    return { InSession: inSession, Dropped: prepared.filter((p) => !used.has(p)), Unknown: unknown };
+}
+/**
+ * Overlays the metadata of tools a host registered handlers for onto the manifest it streamed, by
+ * name (case-insensitive). A registered tool's own description/schema wins when it supplied one; a
+ * bare `{ Name, Handler }` registration (what most hosts do) inherits the manifest's description and
+ * schema instead of showing up with none.
+ *
+ * @param registered The registry's tools as metadata.
+ * @param manifest The tools the host's app-context snapshot advertises (may be empty).
+ */
+export function MergeToolMetadata(registered, manifest) {
+    const fromManifest = new Map(manifest.map((t) => [t.Name.trim().toLowerCase(), t]));
+    return registered.map((tool) => {
+        const advertised = fromManifest.get(tool.Name.trim().toLowerCase());
+        if (!advertised) {
+            return tool;
+        }
+        return {
+            ...advertised,
+            ...tool,
+            Description: tool.Description || advertised.Description,
+            InputSchema: Object.keys(tool.InputSchema ?? {}).length > 0 ? tool.InputSchema : advertised.InputSchema,
+        };
+    });
+}
+//# sourceMappingURL=channel-session-scope.js.map

package/dist/session/channel-session-scope.js.map

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

package/dist/session/client-session-deadline.d.ts

@@ -0,0 +1,28 @@
+import { Observable } from 'rxjs';
+/**
+ * The client's view of when its session must end — the CLIENT half of a limit the server enforces
+ * authoritatively (the janitor closes a session past its stored deadline whatever a client does).
+ *
+ * The client keeps a copy so it can end the call gracefully before the server does, and show a
+ * countdown. It follows one rule: **the server's word moves the deadline only later** when it arrives
+ * as an extension (identity verification relaxes a session's limits) — a stale or hostile value can
+ * therefore never cut a session short here, and nothing a client does with this class extends the
+ * server's deadline.
+ */
+export declare class ClientSessionDeadline {
+    private readonly subject;
+    /** Emits the current deadline (or `null` when none is known), then every change. */
+    readonly Deadline$: Observable<Date | null>;
+    /** The current deadline, or `null` when none is known. */
+    get Value(): Date | null;
+    /** Sets the baseline deadline outright (a host that knows the session's cap at start). `null` clears it. */
+    Set(deadline: Date | null): void;
+    /**
+     * Applies a server-announced deadline: adopted when none is known or when it is LATER than the one
+     * held; ignored when earlier, equal or unparseable. Returns whether the deadline changed.
+     */
+    Extend(deadlineIso: string | undefined): boolean;
+    /** Forgets the deadline (session ended). */
+    Clear(): void;
+}
+//# sourceMappingURL=client-session-deadline.d.ts.map

package/dist/session/client-session-deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-session-deadline.d.ts","sourceRoot":"","sources":["../../src/session/client-session-deadline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,UAAU,EAAE,MAAM,MAAM,CAAC;AAEnD;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE,oFAAoF;IACpF,SAAgB,SAAS,EAAE,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,CAA+B;IAEjF,0DAA0D;IAC1D,IAAW,KAAK,IAAI,IAAI,GAAG,IAAI,CAE9B;IAED,4GAA4G;IACrG,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAIvC;;;OAGG;IACI,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO;IAgBvD,4CAA4C;IACrC,KAAK,IAAI,IAAI;CAGrB"}

package/dist/session/client-session-deadline.js

@@ -0,0 +1,50 @@
+import { BehaviorSubject } from 'rxjs';
+/**
+ * The client's view of when its session must end — the CLIENT half of a limit the server enforces
+ * authoritatively (the janitor closes a session past its stored deadline whatever a client does).
+ *
+ * The client keeps a copy so it can end the call gracefully before the server does, and show a
+ * countdown. It follows one rule: **the server's word moves the deadline only later** when it arrives
+ * as an extension (identity verification relaxes a session's limits) — a stale or hostile value can
+ * therefore never cut a session short here, and nothing a client does with this class extends the
+ * server's deadline.
+ */
+export class ClientSessionDeadline {
+    constructor() {
+        this.subject = new BehaviorSubject(null);
+        /** Emits the current deadline (or `null` when none is known), then every change. */
+        this.Deadline$ = this.subject.asObservable();
+    }
+    /** The current deadline, or `null` when none is known. */
+    get Value() {
+        return this.subject.value;
+    }
+    /** Sets the baseline deadline outright (a host that knows the session's cap at start). `null` clears it. */
+    Set(deadline) {
+        this.subject.next(deadline && Number.isFinite(deadline.getTime()) ? deadline : null);
+    }
+    /**
+     * Applies a server-announced deadline: adopted when none is known or when it is LATER than the one
+     * held; ignored when earlier, equal or unparseable. Returns whether the deadline changed.
+     */
+    Extend(deadlineIso) {
+        if (!deadlineIso) {
+            return false;
+        }
+        const parsed = new Date(deadlineIso);
+        if (!Number.isFinite(parsed.getTime())) {
+            return false;
+        }
+        const current = this.subject.value;
+        if (current !== null && parsed.getTime() <= current.getTime()) {
+            return false;
+        }
+        this.subject.next(parsed);
+        return true;
+    }
+    /** Forgets the deadline (session ended). */
+    Clear() {
+        this.subject.next(null);
+    }
+}
+//# sourceMappingURL=client-session-deadline.js.map

package/dist/session/client-session-deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-session-deadline.js","sourceRoot":"","sources":["../../src/session/client-session-deadline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAc,MAAM,MAAM,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,OAAO,qBAAqB;IAAlC;QACmB,YAAO,GAAG,IAAI,eAAe,CAAc,IAAI,CAAC,CAAC;QAElE,oFAAoF;QACpE,cAAS,GAA4B,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IAoCnF,CAAC;IAlCC,0DAA0D;IAC1D,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,4GAA4G;IACrG,GAAG,CAAC,QAAqB;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvF,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,WAA+B;QAC3C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IACrC,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}