@memberjunction/ai-bridge-teams 5.44.0 → 5.45.0

package/dist/real-teams-bindings.js.map

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

package/dist/teams-graph-acs-client.d.ts

@@ -0,0 +1,209 @@
+/**
+ * @fileoverview Production clients behind the Teams binding seams — the **Microsoft Graph
+ * cloud-communications control plane** ({@link RealGraphCallsClient} over `@microsoft/microsoft-graph-client`)
+ * and the **ACS application-hosted-media audio plane** ({@link PumpBackedAcsMedia} over a server-owned
+ * per-call audio pump).
+ *
+ * ## Why this split (mirrors the Twilio REST / Media-Streams split)
+ * Just like the Twilio binding — REST in-package ({@link import('./real-twilio-bindings')}) and the
+ * bidirectional Media-Streams **websocket** owned by the MJAPI ingress — the Teams binding splits along the
+ * same line:
+ *  - The **Graph control plane** (`POST /communications/calls`, roster, chat, mute, hangup) is a request/
+ *    response REST surface this package can drive directly. {@link RealGraphCallsClient} implements
+ *    {@link IGraphCallsLike} over `@microsoft/microsoft-graph-client`.
+ *  - The **ACS audio plane** (per-participant inbound PCM + the bot's outbound PCM) is a long-lived
+ *    application-hosted-media socket. That socket is a **server** concern (it spans the whole call and the
+ *    `ws` / native-media dependency lives in MJServer), so this package exposes the {@link IAcsMediaPump}
+ *    seam and a tiny {@link PumpBackedAcsMedia} adapter the server's per-call registry feeds — exactly as
+ *    `ITwilioMediaPump` + the server's `TwilioCallMediaRegistry` do for telephony.
+ *
+ * ## Optional peer SDK (CLAUDE rule 8, category 2)
+ * `@microsoft/microsoft-graph-client` is an OPTIONAL PEER SDK — NEVER statically imported, so this provider
+ * package builds and unit-tests with no Graph install and no network. It is lazily loaded (once, memoized)
+ * at first use via the injectable {@link GraphModuleLoader}; tests inject a fake factory. None of the Graph
+ * SDK's own types leak past this file — everything crosses the seam through the minimal structural interfaces
+ * below, keeping {@link RealTeamsBindings} SDK-agnostic. The package declares it in `optionalDependencies`.
+ *
+ * @module @memberjunction/ai-bridge-teams
+ * @author MemberJunction.com
+ * @see {@link IGraphCallsLike} / {@link IAcsMediaLike} — the seams these implement.
+ * @see `/plans/realtime/bridges-and-widget/meeting-vendor-bindings-teams-slack.md` §2 (M1 A).
+ */
+import type { GraphCallParticipant, GraphCreateCallRequest, GraphCreateCallResult, IGraphCallsLike, IAcsMediaLike, AcsInboundAudioFrame } from './real-teams-bindings.js';
+/** One fluent Graph request (`client.api(path)`) — the subset of verbs we issue. */
+export interface GraphRequestLike {
+    /** Issues `POST {path}` with a JSON body; resolves the parsed response. */
+    post(body: unknown): Promise<unknown>;
+    /** Issues `GET {path}`; resolves the parsed response. */
+    get(): Promise<unknown>;
+    /** Issues `DELETE {path}`; resolves when the resource is removed. */
+    delete(): Promise<unknown>;
+}
+/** The constructed Graph client surface — just the `api(path)` request-builder entry point. */
+export interface GraphClientLike {
+    /** Begins a fluent request against a Graph resource path (e.g. `/communications/calls`). */
+    api(path: string): GraphRequestLike;
+}
+/**
+ * The `@microsoft/microsoft-graph-client` module surface we use: the `Client.init({ authProvider })`
+ * static factory. Declared structurally so the SDK's real `Client` type never leaks.
+ */
+export interface GraphModuleLike {
+    /** The `Client` class with its `init` static factory. */
+    Client: {
+        /** Constructs an authenticated Graph client from an auth-provider callback. */
+        init(options: GraphClientInitOptions): GraphClientLike;
+    };
+}
+/** The `Client.init` options subset we pass — just the bearer-token `authProvider` callback. */
+export interface GraphClientInitOptions {
+    /**
+     * The Graph auth-provider callback. The SDK invokes it for each request and expects the bearer access
+     * token (string) via the supplied `done(error, token)` continuation.
+     */
+    authProvider(done: (error: Error | null, accessToken: string | null) => void): void;
+}
+/** Loads the `@microsoft/microsoft-graph-client` module. Overridable in tests; defaults to a lazy dynamic import. */
+export type GraphModuleLoader = () => Promise<GraphModuleLike>;
+/** Credentials {@link RealGraphCallsClient} authenticates Graph with. Resolved upstream via MJ config — never inlined. */
+export interface GraphCallsClientCredentials {
+    /** A pre-resolved OAuth bearer / application token for the bot's Graph calls (resolved upstream). */
+    AccessToken: string;
+    /** The Azure tenant id the bot operates in (carried for diagnostics + cross-tenant joins). */
+    TenantId?: string;
+    /** The bot's Azure AD application (client) id (carried for diagnostics). */
+    AppId?: string;
+}
+/**
+ * Lazily loads the `@microsoft/microsoft-graph-client` module exactly once and memoizes it. A static import
+ * is impossible here (optional peer SDK, may be uninstalled in non-Teams deployments); the
+ * `optionalDependencies` entry keeps it in the dependency graph (CLAUDE rule 8, category 2 — optional peer
+ * SDK loaded only when the Teams provider is configured).
+ */
+export declare const defaultGraphModuleLoader: GraphModuleLoader;
+/**
+ * A real {@link IGraphCallsLike} over the Microsoft Graph cloud-communications REST API
+ * (`@microsoft/microsoft-graph-client`).
+ *
+ * - `CreateCall`           → `POST /communications/calls` with an app-hosted-media join-by-URL body; reads
+ *                            the created call id + the bot participant id from the response.
+ * - `DeleteCall`           → `DELETE /communications/calls/{id}` (the bot's call-leg hangup).
+ * - `GetParticipants`      → `GET /communications/calls/{id}/participants`; maps each to {@link GraphCallParticipant}.
+ * - `PostChatMessage`      → `POST /chats/{threadId}/messages` against the meeting thread.
+ * - `MuteParticipant`      → `POST /communications/calls/{id}/participants/{pid}/mute`.
+ * - `OnParticipantsUpdated`/`OnCallEnded` → arrive over the Graph change-notification **webhook** (the MJAPI
+ *                            ingress), not a client subscription; this REST client retains the handlers so the
+ *                            ingress can drive them via {@link DriveParticipantsUpdated} / {@link DriveCallEnded}.
+ *
+ * The constructed Graph client is built once on first use and reused for the life of the instance.
+ */
+export declare class RealGraphCallsClient implements IGraphCallsLike {
+    private readonly credentials;
+    private readonly loadModule;
+    /** Memoized client-build promise so concurrent callers share one construction. */
+    private clientPromise?;
+    /** Retained webhook handlers, keyed by call id — driven by the MJAPI Graph-notification ingress. */
+    private readonly participantsHandlers;
+    private readonly endedHandlers;
+    /**
+     * @param credentials Resolved Graph credentials (bearer token + tenant/app ids).
+     * @param loadModule The Graph module loader (defaults to the lazy dynamic import).
+     */
+    constructor(credentials: GraphCallsClientCredentials, loadModule?: GraphModuleLoader);
+    /** @inheritdoc */
+    CreateCall(request: GraphCreateCallRequest): Promise<GraphCreateCallResult>;
+    /** @inheritdoc */
+    DeleteCall(callId: string): Promise<void>;
+    /** @inheritdoc */
+    GetParticipants(callId: string): Promise<GraphCallParticipant[]>;
+    /** @inheritdoc */
+    PostChatMessage(threadId: string, text: string): Promise<void>;
+    /** @inheritdoc */
+    MuteParticipant(callId: string, participantId: string): Promise<void>;
+    /** @inheritdoc — retains the handler; the MJAPI Graph-notification ingress drives it via {@link DriveParticipantsUpdated}. */
+    OnParticipantsUpdated(callId: string, handler: (participants: GraphCallParticipant[]) => void): void;
+    /** @inheritdoc — retains the handler; the MJAPI Graph-notification ingress drives it via {@link DriveCallEnded}. */
+    OnCallEnded(callId: string, handler: () => void): void;
+    /**
+     * Drives the retained `participantsUpdated` handler for a call from a Graph change notification (called by
+     * the MJAPI ingress — Graph delivers roster changes over the webhook, not a client subscription).
+     */
+    DriveParticipantsUpdated(callId: string, participants: GraphCallParticipant[]): void;
+    /** Drives the retained `callEnded` handler for a call from a Graph change notification (called by the MJAPI ingress). */
+    DriveCallEnded(callId: string): void;
+    /** Builds (once) and returns the constructed Graph client with the bot's bearer-token auth provider. */
+    private ensureClient;
+    /** Constructs the Graph client, supplying the resolved bot bearer token via the SDK's `authProvider` callback. */
+    private buildClient;
+}
+/** The Graph `POST /communications/calls` body subset we construct for a join-by-URL app-hosted-media bot call. */
+export interface GraphCallPostBody {
+    '@odata.type': '#microsoft.graph.call';
+    callbackUri?: string;
+    mediaConfig: {
+        '@odata.type': '#microsoft.graph.appHostedMediaConfig';
+    };
+    chatInfo: {
+        '@odata.type': '#microsoft.graph.chatInfo';
+        threadId: string;
+    };
+    meetingInfo: {
+        '@odata.type': '#microsoft.graph.joinMeetingIdMeetingInfo' | '#microsoft.graph.organizerMeetingInfo';
+        joinWebUrl?: string;
+    };
+    tenantId?: string;
+}
+/**
+ * **Pure** mapping of the bridge's {@link GraphCreateCallRequest} onto the Graph call POST body. Isolated so
+ * the request shape unit-tests directly and the live client reuses it verbatim.
+ */
+export declare function buildGraphCallBody(request: GraphCreateCallRequest): GraphCallPostBody;
+/** Reads the `{ id, myParticipantId }` of the created call out of the Graph response, without leaking SDK types. */
+export declare function readCreateCallResult(response: unknown): GraphCreateCallResult;
+/** Reads a Graph participants-collection response (`{ value: [...] }`) into {@link GraphCallParticipant}s. */
+export declare function readParticipantsCollection(response: unknown): GraphCallParticipant[];
+/** Reads one Graph participant resource into the bridge's {@link GraphCallParticipant} shape. */
+export declare function readGraphParticipant(raw: unknown): GraphCallParticipant;
+/**
+ * The server-owned per-call audio pump the ACS application-hosted-media plane runs on — the analogue of
+ * `ITwilioMediaPump` for telephony. The long-lived ACS audio socket is a server concern (it spans the whole
+ * call and the native-media / `ws` dependency lives in MJServer), so this seam lets the in-package binding
+ * push the bot's outbound PCM and register for inbound per-participant PCM without ever owning the socket.
+ * Production wires it over the server's per-call ACS media registry; tests inject a fake.
+ */
+export interface IAcsMediaPump {
+    /** The ACS audio-socket sample rate in Hz (e.g. 16000) — drives T0 resampling in {@link RealTeamsBindings}. */
+    readonly SampleRate: number;
+    /** Sends one outbound PCM16 frame on the bot's outbound audio socket for the call (the agent's voice). */
+    Send(callId: string, pcm: ArrayBuffer): void;
+    /** Registers the inbound per-participant audio handler for the call's socket (latest handler wins). */
+    OnFrame(callId: string, handler: (frame: AcsInboundAudioFrame) => void): void;
+    /**
+     * Registers the raised-hand handler for the call when the platform/registry surfaces it. **Optional** —
+     * absence is tolerated by {@link RealTeamsBindings} (the handler simply never fires).
+     */
+    OnHandRaise?(callId: string, handler: (participantId: string, raised: boolean) => void): void;
+}
+/**
+ * Adapts the server-owned per-call {@link IAcsMediaPump} to the call-scoped {@link IAcsMediaLike} surface
+ * {@link RealTeamsBindings} drives. The binding supplies the Graph **call id** on every per-frame call (it
+ * resolves the id at `join()` and threads it through), so this adapter routes each call straight onto the
+ * shared pump keyed by that id — no call-id needs to be known at construction. Mirrors how
+ * `TwilioCallMediaRegistry` backs the telephony media seam.
+ */
+export declare class PumpBackedAcsMedia implements IAcsMediaLike {
+    private readonly pump;
+    /**
+     * @param pump The server-owned per-call ACS audio pump (keyed by Graph call id).
+     */
+    constructor(pump: IAcsMediaPump);
+    /** @inheritdoc */
+    get SampleRate(): number;
+    /** @inheritdoc — routes to the pump keyed by the call id the binding supplies. */
+    SendAudioFrame(callId: string, pcm: ArrayBuffer): void;
+    /** @inheritdoc — routes to the pump keyed by the call id the binding supplies. */
+    OnAudioFrame(callId: string, handler: (frame: AcsInboundAudioFrame) => void): void;
+    /** @inheritdoc — only wires hand-raise when the underlying pump exposes it (tolerated absence). */
+    OnHandRaise(callId: string, handler: (participantId: string, raised: boolean) => void): void;
+}
+//# sourceMappingURL=teams-graph-acs-client.d.ts.map

package/dist/teams-graph-acs-client.d.ts.map

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

package/dist/teams-graph-acs-client.js

@@ -0,0 +1,256 @@
+/**
+ * @fileoverview Production clients behind the Teams binding seams — the **Microsoft Graph
+ * cloud-communications control plane** ({@link RealGraphCallsClient} over `@microsoft/microsoft-graph-client`)
+ * and the **ACS application-hosted-media audio plane** ({@link PumpBackedAcsMedia} over a server-owned
+ * per-call audio pump).
+ *
+ * ## Why this split (mirrors the Twilio REST / Media-Streams split)
+ * Just like the Twilio binding — REST in-package ({@link import('./real-twilio-bindings')}) and the
+ * bidirectional Media-Streams **websocket** owned by the MJAPI ingress — the Teams binding splits along the
+ * same line:
+ *  - The **Graph control plane** (`POST /communications/calls`, roster, chat, mute, hangup) is a request/
+ *    response REST surface this package can drive directly. {@link RealGraphCallsClient} implements
+ *    {@link IGraphCallsLike} over `@microsoft/microsoft-graph-client`.
+ *  - The **ACS audio plane** (per-participant inbound PCM + the bot's outbound PCM) is a long-lived
+ *    application-hosted-media socket. That socket is a **server** concern (it spans the whole call and the
+ *    `ws` / native-media dependency lives in MJServer), so this package exposes the {@link IAcsMediaPump}
+ *    seam and a tiny {@link PumpBackedAcsMedia} adapter the server's per-call registry feeds — exactly as
+ *    `ITwilioMediaPump` + the server's `TwilioCallMediaRegistry` do for telephony.
+ *
+ * ## Optional peer SDK (CLAUDE rule 8, category 2)
+ * `@microsoft/microsoft-graph-client` is an OPTIONAL PEER SDK — NEVER statically imported, so this provider
+ * package builds and unit-tests with no Graph install and no network. It is lazily loaded (once, memoized)
+ * at first use via the injectable {@link GraphModuleLoader}; tests inject a fake factory. None of the Graph
+ * SDK's own types leak past this file — everything crosses the seam through the minimal structural interfaces
+ * below, keeping {@link RealTeamsBindings} SDK-agnostic. The package declares it in `optionalDependencies`.
+ *
+ * @module @memberjunction/ai-bridge-teams
+ * @author MemberJunction.com
+ * @see {@link IGraphCallsLike} / {@link IAcsMediaLike} — the seams these implement.
+ * @see `/plans/realtime/bridges-and-widget/meeting-vendor-bindings-teams-slack.md` §2 (M1 A).
+ */
+/**
+ * Lazily loads the `@microsoft/microsoft-graph-client` module exactly once and memoizes it. A static import
+ * is impossible here (optional peer SDK, may be uninstalled in non-Teams deployments); the
+ * `optionalDependencies` entry keeps it in the dependency graph (CLAUDE rule 8, category 2 — optional peer
+ * SDK loaded only when the Teams provider is configured).
+ */
+export const defaultGraphModuleLoader = async () => {
+    try {
+        const mod = await import('@microsoft/microsoft-graph-client');
+        const resolved = unwrapGraphModule(mod);
+        if (!isGraphModule(resolved)) {
+            throw new Error('the @microsoft/microsoft-graph-client module did not export a Client.init factory');
+        }
+        return resolved;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error("RealGraphCallsClient could not load the '@microsoft/microsoft-graph-client' SDK. Install it in the " +
+            'deployment that runs the Teams meeting bridge (it is an optional peer dependency). ' +
+            `Underlying error: ${message}`);
+    }
+};
+/** Unwraps the Graph module from CJS/ESM interop (`module` or `module.default`). */
+function unwrapGraphModule(mod) {
+    if (isGraphModule(mod)) {
+        return mod;
+    }
+    if (mod && typeof mod === 'object' && 'default' in mod) {
+        const inner = mod.default;
+        if (isGraphModule(inner)) {
+            return inner;
+        }
+    }
+    return mod;
+}
+/** Structural guard: a value is a {@link GraphModuleLike} when it exposes a `Client.init` function. */
+function isGraphModule(value) {
+    if (value == null || typeof value !== 'object') {
+        return false;
+    }
+    const client = value.Client;
+    return client != null && typeof client.init === 'function';
+}
+/**
+ * A real {@link IGraphCallsLike} over the Microsoft Graph cloud-communications REST API
+ * (`@microsoft/microsoft-graph-client`).
+ *
+ * - `CreateCall`           → `POST /communications/calls` with an app-hosted-media join-by-URL body; reads
+ *                            the created call id + the bot participant id from the response.
+ * - `DeleteCall`           → `DELETE /communications/calls/{id}` (the bot's call-leg hangup).
+ * - `GetParticipants`      → `GET /communications/calls/{id}/participants`; maps each to {@link GraphCallParticipant}.
+ * - `PostChatMessage`      → `POST /chats/{threadId}/messages` against the meeting thread.
+ * - `MuteParticipant`      → `POST /communications/calls/{id}/participants/{pid}/mute`.
+ * - `OnParticipantsUpdated`/`OnCallEnded` → arrive over the Graph change-notification **webhook** (the MJAPI
+ *                            ingress), not a client subscription; this REST client retains the handlers so the
+ *                            ingress can drive them via {@link DriveParticipantsUpdated} / {@link DriveCallEnded}.
+ *
+ * The constructed Graph client is built once on first use and reused for the life of the instance.
+ */
+export class RealGraphCallsClient {
+    /**
+     * @param credentials Resolved Graph credentials (bearer token + tenant/app ids).
+     * @param loadModule The Graph module loader (defaults to the lazy dynamic import).
+     */
+    constructor(credentials, loadModule = defaultGraphModuleLoader) {
+        /** Retained webhook handlers, keyed by call id — driven by the MJAPI Graph-notification ingress. */
+        this.participantsHandlers = new Map();
+        this.endedHandlers = new Map();
+        this.credentials = credentials;
+        this.loadModule = loadModule;
+    }
+    /** @inheritdoc */
+    async CreateCall(request) {
+        const client = await this.ensureClient();
+        const body = buildGraphCallBody(request);
+        const response = await client.api('/communications/calls').post(body);
+        return readCreateCallResult(response);
+    }
+    /** @inheritdoc */
+    async DeleteCall(callId) {
+        const client = await this.ensureClient();
+        await client.api(`/communications/calls/${encodeURIComponent(callId)}`).delete();
+    }
+    /** @inheritdoc */
+    async GetParticipants(callId) {
+        const client = await this.ensureClient();
+        const response = await client.api(`/communications/calls/${encodeURIComponent(callId)}/participants`).get();
+        return readParticipantsCollection(response);
+    }
+    /** @inheritdoc */
+    async PostChatMessage(threadId, text) {
+        const client = await this.ensureClient();
+        await client.api(`/chats/${encodeURIComponent(threadId)}/messages`).post({ body: { content: text } });
+    }
+    /** @inheritdoc */
+    async MuteParticipant(callId, participantId) {
+        const client = await this.ensureClient();
+        await client
+            .api(`/communications/calls/${encodeURIComponent(callId)}/participants/${encodeURIComponent(participantId)}/mute`)
+            .post({});
+    }
+    /** @inheritdoc — retains the handler; the MJAPI Graph-notification ingress drives it via {@link DriveParticipantsUpdated}. */
+    OnParticipantsUpdated(callId, handler) {
+        this.participantsHandlers.set(callId, handler);
+    }
+    /** @inheritdoc — retains the handler; the MJAPI Graph-notification ingress drives it via {@link DriveCallEnded}. */
+    OnCallEnded(callId, handler) {
+        this.endedHandlers.set(callId, handler);
+    }
+    /**
+     * Drives the retained `participantsUpdated` handler for a call from a Graph change notification (called by
+     * the MJAPI ingress — Graph delivers roster changes over the webhook, not a client subscription).
+     */
+    DriveParticipantsUpdated(callId, participants) {
+        this.participantsHandlers.get(callId)?.(participants);
+    }
+    /** Drives the retained `callEnded` handler for a call from a Graph change notification (called by the MJAPI ingress). */
+    DriveCallEnded(callId) {
+        this.endedHandlers.get(callId)?.();
+    }
+    /** Builds (once) and returns the constructed Graph client with the bot's bearer-token auth provider. */
+    ensureClient() {
+        if (!this.clientPromise) {
+            this.clientPromise = this.buildClient();
+        }
+        return this.clientPromise;
+    }
+    /** Constructs the Graph client, supplying the resolved bot bearer token via the SDK's `authProvider` callback. */
+    async buildClient() {
+        const mod = await this.loadModule();
+        const token = this.credentials.AccessToken;
+        if (!token) {
+            throw new Error('RealGraphCallsClient requires a resolved AccessToken (the bot bearer token).');
+        }
+        return mod.Client.init({ authProvider: (done) => done(null, token) });
+    }
+}
+/**
+ * **Pure** mapping of the bridge's {@link GraphCreateCallRequest} onto the Graph call POST body. Isolated so
+ * the request shape unit-tests directly and the live client reuses it verbatim.
+ */
+export function buildGraphCallBody(request) {
+    return {
+        '@odata.type': '#microsoft.graph.call',
+        mediaConfig: { '@odata.type': '#microsoft.graph.appHostedMediaConfig' },
+        chatInfo: { '@odata.type': '#microsoft.graph.chatInfo', threadId: request.ThreadId },
+        meetingInfo: { '@odata.type': '#microsoft.graph.joinMeetingIdMeetingInfo', joinWebUrl: request.JoinWebUrl },
+        ...(request.TenantId ? { tenantId: request.TenantId } : {}),
+    };
+}
+/** Reads the `{ id, myParticipantId }` of the created call out of the Graph response, without leaking SDK types. */
+export function readCreateCallResult(response) {
+    const obj = asRecord(response);
+    const callId = readString(obj?.id);
+    if (!callId) {
+        throw new Error('Graph POST /communications/calls returned no call id.');
+    }
+    const botParticipantId = readString(obj?.myParticipantId) ?? callId;
+    return { CallId: callId, BotParticipantId: botParticipantId };
+}
+/** Reads a Graph participants-collection response (`{ value: [...] }`) into {@link GraphCallParticipant}s. */
+export function readParticipantsCollection(response) {
+    const obj = asRecord(response);
+    const value = obj?.value;
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.map(readGraphParticipant);
+}
+/** Reads one Graph participant resource into the bridge's {@link GraphCallParticipant} shape. */
+export function readGraphParticipant(raw) {
+    const p = asRecord(raw);
+    const info = asRecord(p?.info);
+    const identity = asRecord(info?.identity);
+    const user = asRecord(identity?.user);
+    const mediaStreams = Array.isArray(p?.mediaStreams) ? p?.mediaStreams : undefined;
+    return {
+        id: readString(p?.id) ?? '',
+        displayName: readString(user?.displayName),
+        role: readString(p?.role) ?? readString(p?.meetingRole),
+        // Graph marks the bot leg via `isMuted`/`isInLobby` flags; `info.identity.application` distinguishes
+        // an application identity (the bot) from a `user` identity.
+        isSelf: identity?.application != null && mediaStreams != null,
+    };
+}
+/** Narrows an unknown value to a record, or `undefined`. */
+function asRecord(value) {
+    return value != null && typeof value === 'object' ? value : undefined;
+}
+/** Reads a value as a non-empty string, or `undefined`. */
+function readString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/**
+ * Adapts the server-owned per-call {@link IAcsMediaPump} to the call-scoped {@link IAcsMediaLike} surface
+ * {@link RealTeamsBindings} drives. The binding supplies the Graph **call id** on every per-frame call (it
+ * resolves the id at `join()` and threads it through), so this adapter routes each call straight onto the
+ * shared pump keyed by that id — no call-id needs to be known at construction. Mirrors how
+ * `TwilioCallMediaRegistry` backs the telephony media seam.
+ */
+export class PumpBackedAcsMedia {
+    /**
+     * @param pump The server-owned per-call ACS audio pump (keyed by Graph call id).
+     */
+    constructor(pump) {
+        this.pump = pump;
+    }
+    /** @inheritdoc */
+    get SampleRate() {
+        return this.pump.SampleRate;
+    }
+    /** @inheritdoc — routes to the pump keyed by the call id the binding supplies. */
+    SendAudioFrame(callId, pcm) {
+        this.pump.Send(callId, pcm);
+    }
+    /** @inheritdoc — routes to the pump keyed by the call id the binding supplies. */
+    OnAudioFrame(callId, handler) {
+        this.pump.OnFrame(callId, handler);
+    }
+    /** @inheritdoc — only wires hand-raise when the underlying pump exposes it (tolerated absence). */
+    OnHandRaise(callId, handler) {
+        this.pump.OnHandRaise?.(callId, handler);
+    }
+}
+//# sourceMappingURL=teams-graph-acs-client.js.map

package/dist/teams-graph-acs-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-graph-acs-client.js","sourceRoot":"","sources":["../src/teams-graph-acs-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAoEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAsB,KAAK,IAA8B,EAAE;IAC5F,IAAI,CAAC;QACD,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;QACzG,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CACX,qGAAqG;YACjG,qFAAqF;YACrF,qBAAqB,OAAO,EAAE,CACrC,CAAC;IACN,CAAC;AACL,CAAC,CAAC;AAEF,oFAAoF;AACpF,SAAS,iBAAiB,CAAC,GAAY;IACnC,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC;IACf,CAAC;IACD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QACrD,MAAM,KAAK,GAAI,GAA4B,CAAC,OAAO,CAAC;QACpD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,uGAAuG;AACvG,SAAS,aAAa,CAAC,KAAc;IACjC,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAI,KAAyC,CAAC,MAAM,CAAC;IACjE,OAAO,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,oBAAoB;IAU7B;;;OAGG;IACH,YAAY,WAAwC,EAAE,aAAgC,wBAAwB;QAR9G,oGAAoG;QACnF,yBAAoB,GAAG,IAAI,GAAG,EAA0D,CAAC;QACzF,kBAAa,GAAG,IAAI,GAAG,EAAsB,CAAC;QAO3D,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,UAAU,CAAC,OAA+B;QACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,UAAU,CAAC,MAAc;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC,GAAG,CAAC,yBAAyB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACrF,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,eAAe,CAAC,MAAc;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,yBAAyB,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5G,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,IAAY;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC,GAAG,CAAC,UAAU,kBAAkB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,eAAe,CAAC,MAAc,EAAE,aAAqB;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,MAAM;aACP,GAAG,CAAC,yBAAyB,kBAAkB,CAAC,MAAM,CAAC,iBAAiB,kBAAkB,CAAC,aAAa,CAAC,OAAO,CAAC;aACjH,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,8HAA8H;IACvH,qBAAqB,CAAC,MAAc,EAAE,OAAuD;QAChG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,oHAAoH;IAC7G,WAAW,CAAC,MAAc,EAAE,OAAmB;QAClD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACI,wBAAwB,CAAC,MAAc,EAAE,YAAoC;QAChF,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED,yHAAyH;IAClH,cAAc,CAAC,MAAc;QAChC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;IACvC,CAAC;IAED,wGAAwG;IAChG,YAAY;QAChB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,kHAAkH;IAC1G,KAAK,CAAC,WAAW;QACrB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;QACpG,CAAC;QACD,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;CACJ;AAiBD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA+B;IAC9D,OAAO;QACH,aAAa,EAAE,uBAAuB;QACtC,WAAW,EAAE,EAAE,aAAa,EAAE,uCAAuC,EAAE;QACvE,QAAQ,EAAE,EAAE,aAAa,EAAE,2BAA2B,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;QACpF,WAAW,EAAE,EAAE,aAAa,EAAE,2CAA2C,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE;QAC3G,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,CAAC;AACN,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,oBAAoB,CAAC,QAAiB;IAClD,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,gBAAgB,GAAG,UAAU,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,MAAM,CAAC;IACpE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;AAClE,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,0BAA0B,CAAC,QAAiB;IACxD,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAC3C,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC7C,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,OAAO;QACH,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE;QAC3B,WAAW,EAAE,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC;QAC1C,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,WAAW,CAAC;QACvD,qGAAqG;QACrG,4DAA4D;QAC5D,MAAM,EAAE,QAAQ,EAAE,WAAW,IAAI,IAAI,IAAI,YAAY,IAAI,IAAI;KAChE,CAAC;AACN,CAAC;AAED,4DAA4D;AAC5D,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvG,CAAC;AAED,2DAA2D;AAC3D,SAAS,UAAU,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AA4BD;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAG3B;;OAEG;IACH,YAAY,IAAmB;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,kBAAkB;IAClB,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;IAChC,CAAC;IAED,kFAAkF;IAC3E,cAAc,CAAC,MAAc,EAAE,GAAgB;QAClD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,kFAAkF;IAC3E,YAAY,CAAC,MAAc,EAAE,OAA8C;QAC9E,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,mGAAmG;IAC5F,WAAW,CAAC,MAAc,EAAE,OAAyD;QACxF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACJ"}

package/dist/teams-ingress.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview Microsoft Graph change-notification **ingress** pure helpers — the validation-token
+ * handshake, the `clientState` shared-secret check, and the call/participant notification → normalized
+ * state mapper, plus a `buildJoinByUrlRequest` convenience. These are the framework-free pieces of the
+ * MJAPI Teams ingress: no Express, no network, no DB, so they unit-test directly and the MJAPI router can
+ * call them verbatim once the live wiring lands.
+ *
+ * The remaining **live** ingress — the `POST /meetings/teams/notifications` endpoint, the
+ * `Meeting.JoinByUrl(agentIdentityId, joinUrl)` mutation, and the Azure AD app registration (Graph
+ * cloud-communications + chat permissions with tenant admin consent) — is documented in
+ * `plans/realtime/bridges-and-widget/spikes/M1-teams-binding-notes.md` and is gated on real Teams/Azure
+ * credentials + a publicly reachable Graph webhook URL.
+ *
+ * @module @memberjunction/ai-bridge-teams
+ * @author MemberJunction.com
+ * @see `/plans/realtime/bridges-and-widget/meeting-vendor-bindings-teams-slack.md` §2 (M1 B/C).
+ */
+import { GraphCallParticipant, GraphCreateCallRequest } from './real-teams-bindings.js';
+/**
+ * The result of the Graph change-notification **validation-token handshake**. When Microsoft Graph creates
+ * (or renews) a subscription, it first calls the notification URL with a `?validationToken=…` query param and
+ * expects the endpoint to echo that exact token back as `text/plain` with `200`. {@link validateGraphNotification}
+ * returns this discriminated result so the router can either echo the token (handshake) or proceed to process
+ * a real notification (with the `clientState` already verified).
+ */
+export type GraphNotificationValidation = {
+    /** A subscription-validation handshake — echo {@link ValidationToken} back as `text/plain` 200. */
+    Kind: 'validation';
+    /** The exact token to echo back (Graph rejects the subscription on any mismatch). */
+    ValidationToken: string;
+} | {
+    /** A real change notification whose `clientState` matched the expected shared secret — process it. */
+    Kind: 'notification';
+} | {
+    /** Reject — either a missing/blank token on a handshake, or a `clientState` mismatch on a notification. */
+    Kind: 'reject';
+    /** A short machine-readable reason (for logging; never surfaced to the caller). */
+    Reason: 'empty-validation-token' | 'client-state-mismatch';
+};
+/**
+ * Performs the Graph change-notification gate, pure + exported so the MJAPI router calls it on every
+ * `POST /meetings/teams/notifications` request (these can't carry an MJ JWT — the handshake + `clientState`
+ * shared secret are the gate):
+ *
+ * 1. If the request carries a `validationToken` query param, it's the subscription-validation handshake →
+ *    return `{ Kind: 'validation', ValidationToken }` (the router echoes it back as `text/plain` 200). A
+ *    blank token rejects.
+ * 2. Otherwise it's a real notification. Every notification in the batch carries a `clientState`; verify
+ *    each (constant-time) against the secret we set when creating the subscription. Any mismatch rejects the
+ *    whole batch (an attacker who can't produce the secret must not drive bot behavior).
+ *
+ * @param validationToken The `?validationToken=…` query param value, when present (the handshake).
+ * @param expectedClientState The shared secret set on subscription creation (resolved upstream — never inlined).
+ * @param notificationClientStates The `clientState` of each notification in the POST body (empty for handshake).
+ * @returns The discriminated validation result.
+ */
+export declare function validateGraphNotification(validationToken: string | undefined, expectedClientState: string, notificationClientStates: ReadonlyArray<string | undefined>): GraphNotificationValidation;
+/** The normalized lifecycle state of a Teams call, mapped from a Graph call/participant notification. */
+export type NormalizedCallState = 'establishing' | 'established' | 'terminating' | 'terminated' | 'unknown';
+/** A normalized view of a Graph call/participant change notification — what the ingress hands the engine. */
+export interface NormalizedCallNotification {
+    /** The Graph call id the notification is about (`/communications/calls/{id}`). */
+    callId: string;
+    /** The normalized call lifecycle state. */
+    state: NormalizedCallState;
+    /** The current participants, normalized (empty when the notification carries no roster). */
+    participants: GraphCallParticipant[];
+}
+/** One raw Graph change-notification item (the subset of the `value[]` array fields we read). */
+export interface GraphChangeNotification {
+    /** The resource path the change is about (e.g. `communications/calls/{id}` or `.../participants`). */
+    resource?: string;
+    /** The shared secret we set on subscription creation (verified by {@link validateGraphNotification}). */
+    clientState?: string;
+    /** The notification's resource payload (the call or participants snapshot). */
+    resourceData?: GraphCallResourceData;
+}
+/** The `resourceData` payload of a Graph call/participant notification (the subset we read). */
+export interface GraphCallResourceData {
+    /** The Graph call id, when the notification carries it directly. */
+    id?: string;
+    /** The call's lifecycle state string (`'establishing'` / `'established'` / `'terminated'`, etc.). */
+    state?: string;
+    /** The participants snapshot, when the notification is a `participantsUpdated`. */
+    participants?: GraphCallParticipant[];
+}
+/**
+ * **Pure** mapping of a Graph call/participant change notification to a {@link NormalizedCallNotification}
+ * (`{ callId, state, participants }`). Resolves the call id from `resourceData.id` or the `resource` path,
+ * normalizes the lifecycle state, and passes the participants snapshot through unchanged. Exported so the
+ * MJAPI router maps each notification → engine session lifecycle without re-parsing Graph's resource shapes.
+ *
+ * @param notification One Graph change-notification item.
+ * @returns The normalized call notification.
+ * @throws When no call id can be resolved (a notification with no identifiable call is unactionable).
+ */
+export declare function parseCallNotification(notification: GraphChangeNotification): NormalizedCallNotification;
+/**
+ * Builds the Graph `POST /communications/calls` request body for an on-demand **join-by-URL** trigger, the
+ * payload the live `Meeting.JoinByUrl(agentIdentityId, joinUrl)` mutation hands the engine. Thin wrapper over
+ * {@link buildGraphCreateCallRequest} that constructs the minimal {@link TeamsJoinArgs} from a join URL + bot
+ * name; pure so the router and tests share one request shape.
+ *
+ * @param joinUrl The Teams meeting join URL to join.
+ * @param botDisplayName The bot's display name in the participant list (defaults to `'AI Agent'`).
+ * @param tenantId The Azure tenant id, when joining cross-tenant.
+ * @returns The Graph create-call request body.
+ * @throws When the join URL carries no resolvable meeting thread id.
+ */
+export declare function buildJoinByUrlRequest(joinUrl: string, botDisplayName?: string, tenantId?: string): GraphCreateCallRequest;
+//# sourceMappingURL=teams-ingress.d.ts.map

package/dist/teams-ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-ingress.d.ts","sourceRoot":"","sources":["../src/teams-ingress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAA+B,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGlH;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GACjC;IACI,mGAAmG;IACnG,IAAI,EAAE,YAAY,CAAC;IACnB,qFAAqF;IACrF,eAAe,EAAE,MAAM,CAAC;CAC3B,GACD;IACI,sGAAsG;IACtG,IAAI,EAAE,cAAc,CAAC;CACxB,GACD;IACI,2GAA2G;IAC3G,IAAI,EAAE,QAAQ,CAAC;IACf,mFAAmF;IACnF,MAAM,EAAE,wBAAwB,GAAG,uBAAuB,CAAC;CAC9D,CAAC;AAER;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACrC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,mBAAmB,EAAE,MAAM,EAC3B,wBAAwB,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,GAC5D,2BAA2B,CAY7B;AAED,yGAAyG;AACzG,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,aAAa,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAE5G,6GAA6G;AAC7G,MAAM,WAAW,0BAA0B;IACvC,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,4FAA4F;IAC5F,YAAY,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAED,iGAAiG;AACjG,MAAM,WAAW,uBAAuB;IACpC,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED,gGAAgG;AAChG,MAAM,WAAW,qBAAqB;IAClC,oEAAoE;IACpE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qGAAqG;IACrG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,uBAAuB,GAAG,0BAA0B,CAavG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,EACf,cAAc,SAAa,EAC3B,QAAQ,CAAC,EAAE,MAAM,GAClB,sBAAsB,CAOxB"}