@memberjunction/server 5.43.0 → 5.45.0

package/dist/telephony/VonageTelephonyService.js

@@ -0,0 +1,191 @@
+/**
+ * @fileoverview Orchestrates Vonage telephony bridge sessions (inbound + outbound) for MJAPI.
+ *
+ * This is the composition layer between the carrier ingress (the public answer/event webhooks + the
+ * bidirectional media WSS) and the ONE unified realtime-agent pathway. It does NOT re-implement any
+ * bridge logic: it resolves the Vonage provider + the agent identity, opens a server-side realtime
+ * session via the agent layer's `CreateBridgeRealtimeSession` factory, binds `RealVonageBindings` (real
+ * REST Voice client + the per-call media registry) onto the driver, and hands everything to
+ * `AIBridgeEngine.StartBridgeSession` — exactly the seam the Twilio service + LiveKit room coordinator use.
+ *
+ * Collaborators are injected (engine, session factory, session manager) so the resolution/branching
+ * logic is unit-testable with fakes; the actual call placement + media flow are live-only (real Vonage
+ * credentials + a publicly reachable media URL — see telephony-vendor-bindings.md §T2).
+ *
+ * @module @memberjunction/server/telephony
+ */
+import { RunView, LogError } from '@memberjunction/core';
+import { AIBridgeEngine } from '@memberjunction/ai-bridge-server';
+import { CreateBridgeRealtimeSession } from '@memberjunction/ai-agents';
+import { DIRECTION_CONFIG_KEY, FROM_NUMBER_CONFIG_KEY, INBOUND_CALL_ID_CONFIG_KEY, } from '@memberjunction/ai-bridge-base';
+import { VonageCallSdk, RealVonageBindings, RealVonageVoiceClient } from '@memberjunction/ai-bridge-vonage';
+import { SessionManager } from '../agentSessions/SessionManager.js';
+const VONAGE_PROVIDER_DRIVER = 'VonageBridge';
+const AGENT_IDENTITY_ENTITY = 'MJ: AI Bridge Agent Identities';
+const PHONE_IDENTITY_TYPE = 'PhoneNumber';
+/**
+ * Starts Vonage bridge sessions. One instance per server, constructed alongside the telephony router and
+ * sharing the {@link VonageCallMediaRegistry} with the media WSS server.
+ */
+export class VonageTelephonyService {
+    constructor(config, registry, deps = {}) {
+        this.config = config;
+        this.registry = registry;
+        this.voice = new RealVonageVoiceClient({
+            ApplicationId: config.applicationId,
+            PrivateKey: config.privateKey,
+            ApiKey: config.apiKey,
+            ApiSecret: config.apiSecret,
+        });
+        this.engine = deps.engine ?? AIBridgeEngine.Instance;
+        this.sessionFactory = deps.sessionFactory ?? CreateBridgeRealtimeSession;
+        this.sessionManager = deps.sessionManager ?? new SessionManager();
+    }
+    /**
+     * Resolves the dialed DID to a pinned agent and starts an INBOUND bridge session. The bound
+     * `RealVonageBindings` will accept the media socket (opened by the answer webhook's `connect` NCCO)
+     * for the call UUID. Returns `{ accepted:false }` (never throws) when no agent identity matches the
+     * DID, so the webhook can answer with a polite "no agent" NCCO instead of a 500.
+     */
+    async HandleInboundCall(input, contextUser, provider) {
+        try {
+            const identity = await this.resolveAgentIdentityByPhone(input.to, contextUser);
+            if (!identity) {
+                return { accepted: false, reason: `No active agent identity for dialed number '${input.to}'.` };
+            }
+            this.registry.RegisterCall(input.callId);
+            await this.startBridge({
+                agentID: identity.AgentID,
+                direction: 'Inbound',
+                address: input.from,
+                inboundCallId: input.callId,
+                contextUser,
+                provider,
+            });
+            return { accepted: true };
+        }
+        catch (e) {
+            LogError(`[Telephony][Vonage] inbound call ${input.callId} failed: ${e instanceof Error ? e.message : String(e)}`);
+            return { accepted: false, reason: 'Internal error starting the agent.' };
+        }
+    }
+    /**
+     * Places an OUTBOUND call from a given agent identity to a destination number. The bound
+     * `RealVonageBindings.createCall` issues the Voice REST `POST /v1/calls` with the `connect`-websocket
+     * NCCO; the returned call UUID is the bridge's external connection id.
+     *
+     * @returns The placed call UUID.
+     */
+    async PlaceOutboundCall(agentIdentityId, toNumber, contextUser, provider) {
+        const identity = await this.loadAgentIdentity(agentIdentityId, contextUser, provider);
+        if (!identity) {
+            throw new Error(`Agent identity '${agentIdentityId}' not found or inactive.`);
+        }
+        const session = await this.startBridge({
+            agentID: identity.AgentID,
+            direction: 'Outbound',
+            address: toNumber,
+            fromNumber: identity.IdentityValue,
+            contextUser,
+            provider,
+        });
+        return session.RoomKey ?? '';
+    }
+    // ── internals ────────────────────────────────────────────────────────────────
+    /** Shared inbound/outbound bridge-start: resolve provider, open the realtime session, bind the SDK, start. */
+    async startBridge(args) {
+        await this.engine.Config(false, args.contextUser, args.provider);
+        const vonageProvider = this.resolveProvider();
+        const agentSession = await this.sessionManager.CreateSession({ agentID: args.agentID, userID: args.contextUser.ID }, args.contextUser, args.provider);
+        const realtimeSession = await this.sessionFactory({
+            AgentID: args.agentID,
+            TargetAgentID: args.agentID,
+            ContextUser: args.contextUser,
+            MetadataProvider: args.provider,
+            AgentSessionID: agentSession.ID,
+            RoomName: args.address,
+        });
+        const active = await this.engine.StartBridgeSession({
+            AgentSessionID: agentSession.ID,
+            AgentID: args.agentID,
+            TargetAgentID: args.agentID,
+            Provider: vonageProvider,
+            RealtimeSession: realtimeSession,
+            Address: args.address,
+            Direction: args.direction,
+            Configuration: this.buildSessionConfiguration(args.direction, args.fromNumber, args.inboundCallId),
+            BindSdk: this.buildBindSdk(),
+            ContextUser: args.contextUser,
+            MetadataProvider: args.provider,
+        });
+        return { RoomKey: active.RoomKey };
+    }
+    /** Resolves the seeded Vonage provider row (by driver class, falling back to display name). */
+    resolveProvider() {
+        const provider = this.engine.ProviderByDriverClass(VONAGE_PROVIDER_DRIVER) ?? this.engine.ProviderByName('Vonage');
+        if (!provider) {
+            throw new Error(`No active 'MJ: AI Bridge Providers' row for the Vonage bridge (DriverClass '${VONAGE_PROVIDER_DRIVER}').`);
+        }
+        return provider;
+    }
+    /**
+     * Builds the per-session SDK binding that wires the REAL Vonage bindings (REST Voice client + the
+     * per-call media registry) onto the telephony driver — overriding the package's default unbound SDK.
+     * This is where the offline-complete seams meet the live REST + websocket plumbing.
+     */
+    buildBindSdk() {
+        return (driver) => {
+            const telephony = driver;
+            telephony.SetSdkFactory(() => new VonageCallSdk(new RealVonageBindings({
+                Voice: this.voice,
+                MediaPump: this.registry,
+                MediaWssUrl: this.config.mediaPublicUrl,
+                EventUrl: this.config.eventUrl,
+            })));
+        };
+    }
+    /** Assembles the per-session bridge configuration (direction/from-number/inbound-call-id config keys). */
+    buildSessionConfiguration(direction, fromNumber, inboundCallId) {
+        // The engine does NOT forward the top-level Direction into the driver's Configuration; the bridge
+        // defaults to 'Outbound' when the key is absent. Set it here so an inbound call answers instead of
+        // wrongly taking the outbound-dial path ("No 'From' number is specified").
+        const config = { [DIRECTION_CONFIG_KEY]: direction };
+        if (fromNumber) {
+            config[FROM_NUMBER_CONFIG_KEY] = fromNumber;
+        }
+        if (inboundCallId) {
+            config[INBOUND_CALL_ID_CONFIG_KEY] = inboundCallId;
+        }
+        return config;
+    }
+    /** Finds the active agent identity whose phone number matches the dialed DID. */
+    async resolveAgentIdentityByPhone(dialedNumber, contextUser) {
+        const normalized = (dialedNumber ?? '').trim();
+        if (!normalized) {
+            return null;
+        }
+        const rv = new RunView();
+        const result = await rv.RunView({
+            EntityName: AGENT_IDENTITY_ENTITY,
+            ExtraFilter: `IdentityType='${PHONE_IDENTITY_TYPE}' AND IdentityValue='${normalized.replace(/'/g, "''")}' AND IsActive=1`,
+            MaxRows: 1,
+            ResultType: 'entity_object',
+        }, contextUser);
+        if (!result.Success) {
+            LogError(`[Telephony][Vonage] agent-identity lookup failed: ${result.ErrorMessage}`);
+            return null;
+        }
+        return result.Results?.[0] ?? null;
+    }
+    /** Loads a specific agent identity by id (used by outbound PlaceCall), requiring it be active. */
+    async loadAgentIdentity(agentIdentityId, contextUser, provider) {
+        // Use the request-scoped provider (multi-provider safe), not the global Metadata.
+        const entity = await provider.GetEntityObject(AGENT_IDENTITY_ENTITY, contextUser);
+        const loaded = await entity.Load(agentIdentityId);
+        if (!loaded || !entity.IsActive) {
+            return null;
+        }
+        return entity;
+    }
+}
+//# sourceMappingURL=VonageTelephonyService.js.map

package/dist/telephony/VonageTelephonyService.js.map

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

package/dist/telephony/calendar-scheduler.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview Host wiring for the scheduled/invite-driven meeting join loop (program M2).
+ *
+ * Composes the offline-complete seams from `@memberjunction/ai-bridge-server` into a running
+ * background loop, mirroring the {@link SessionJanitor} startup pattern (run once at boot, then on an
+ * interval):
+ *
+ *   1. {@link CalendarWatcher} polls each agent identity's calendar (via the injected
+ *      {@link CalendarSourceResolver}, bound here to the real {@link GraphCalendarClient} /
+ *      {@link GoogleCalendarClient}) and creates a `Scheduled` `AIAgentSessionBridge` for every invite
+ *      addressed to the agent.
+ *   2. {@link ScheduledBridgeRunner} starts each bridge whose `ScheduledStartTime` is due, building the
+ *      realtime session + the provider bind-sdk via the per-provider meeting service (Teams today).
+ *
+ * Calendar credentials are PRE-RESOLVED upstream (the bot's Graph access token comes from the Teams
+ * meetings config — `botAccessToken`, resolved via MJ config, never inline). Google calendar polling
+ * binds only when a Google auth client is supplied; otherwise those identities are skipped (the watcher
+ * tolerates a `null` source per identity). Live verification requires a real tenant + the Azure app /
+ * Google service account — the same access the meeting bridges need.
+ *
+ * @module @memberjunction/server/telephony
+ */
+import { UserInfo, IMetadataProvider } from '@memberjunction/core';
+import { type CalendarSourceResolver, type ScheduledBridgeSessionFactory } from '@memberjunction/ai-bridge-server';
+import type { TeamsMeetingsConfig } from '../config.js';
+import { TeamsMeetingsService } from './TeamsMeetingsService.js';
+/** Options for {@link StartCalendarScheduler}. */
+export interface CalendarSchedulerOptions {
+    /** The server metadata provider all reads/writes run under. */
+    Provider: IMetadataProvider;
+    /** The system user the watcher + runner (and every created/started bridge) run as. */
+    ContextUser: UserInfo;
+    /** The Teams meetings service (shared with the ingress) — supplies the scheduled-join bind-sdk. */
+    TeamsService: TeamsMeetingsService;
+    /** The Teams meetings config — supplies the bot Graph access token for calendar polling. */
+    TeamsConfig: TeamsMeetingsConfig;
+    /** Poll cadence (ms). Defaults to {@link DEFAULT_POLL_INTERVAL_MS}. */
+    PollIntervalMs?: number;
+}
+/** A running scheduler handle — call {@link CalendarSchedulerHandle.Stop} to clear the interval. */
+export interface CalendarSchedulerHandle {
+    /** Stops the periodic sweep/run loop (clears the timer). Safe to call more than once. */
+    Stop(): void;
+}
+/**
+ * Builds the {@link CalendarSourceResolver} that binds the real calendar clients per identity. Graph
+ * (Teams/Microsoft) identities bind a {@link GraphCalendarClient} authenticated with the bot's
+ * pre-resolved Graph token; any identity without configured credentials resolves to `null` and is
+ * skipped this sweep (the watcher tolerates that). Google binding activates when a Google auth client
+ * is wired into the deployment (none configured today → Google-backed identities are skipped).
+ */
+export declare function buildCalendarSourceResolver(teamsConfig: TeamsMeetingsConfig): CalendarSourceResolver;
+/**
+ * Builds the {@link ScheduledBridgeSessionFactory} that turns a due bridge into start params. Resolves
+ * the bridge's agent (via its `AIAgentSession`) and, for a Teams bridge, delegates to the shared
+ * {@link TeamsMeetingsService} so the scheduled join reuses the exact provider/session/bind-sdk path as
+ * an on-demand join. Returns `null` (skip) for a provider with no scheduled-join wiring yet, or when the
+ * bridge has no join address.
+ */
+export declare function buildScheduledSessionFactory(teamsService: TeamsMeetingsService): ScheduledBridgeSessionFactory;
+/**
+ * Starts the calendar/scheduled-bridge loop: sweeps calendars and runs due bridges once immediately,
+ * then on a fixed interval. Mirrors {@link SessionJanitor.Start}. A sweep/run failure is logged and the
+ * loop continues — a transient calendar/transport error never kills the scheduler.
+ */
+export declare function StartCalendarScheduler(options: CalendarSchedulerOptions): CalendarSchedulerHandle;
+//# sourceMappingURL=calendar-scheduler.d.ts.map

package/dist/telephony/calendar-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-scheduler.d.ts","sourceRoot":"","sources":["../../src/telephony/calendar-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAuB,MAAM,sBAAsB,CAAC;AAExF,OAAO,EAKH,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAErC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAQjE,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACrC,+DAA+D;IAC/D,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,sFAAsF;IACtF,WAAW,EAAE,QAAQ,CAAC;IACtB,mGAAmG;IACnG,YAAY,EAAE,oBAAoB,CAAC;IACnC,4FAA4F;IAC5F,WAAW,EAAE,mBAAmB,CAAC;IACjC,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,oGAAoG;AACpG,MAAM,WAAW,uBAAuB;IACpC,yFAAyF;IACzF,IAAI,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,mBAAmB,GAAG,sBAAsB,CAgBpG;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,oBAAoB,GAAG,6BAA6B,CAyB9G;AAeD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CAmCjG"}

package/dist/telephony/calendar-scheduler.js

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview Host wiring for the scheduled/invite-driven meeting join loop (program M2).
+ *
+ * Composes the offline-complete seams from `@memberjunction/ai-bridge-server` into a running
+ * background loop, mirroring the {@link SessionJanitor} startup pattern (run once at boot, then on an
+ * interval):
+ *
+ *   1. {@link CalendarWatcher} polls each agent identity's calendar (via the injected
+ *      {@link CalendarSourceResolver}, bound here to the real {@link GraphCalendarClient} /
+ *      {@link GoogleCalendarClient}) and creates a `Scheduled` `AIAgentSessionBridge` for every invite
+ *      addressed to the agent.
+ *   2. {@link ScheduledBridgeRunner} starts each bridge whose `ScheduledStartTime` is due, building the
+ *      realtime session + the provider bind-sdk via the per-provider meeting service (Teams today).
+ *
+ * Calendar credentials are PRE-RESOLVED upstream (the bot's Graph access token comes from the Teams
+ * meetings config — `botAccessToken`, resolved via MJ config, never inline). Google calendar polling
+ * binds only when a Google auth client is supplied; otherwise those identities are skipped (the watcher
+ * tolerates a `null` source per identity). Live verification requires a real tenant + the Azure app /
+ * Google service account — the same access the meeting bridges need.
+ *
+ * @module @memberjunction/server/telephony
+ */
+import { LogStatus, LogError } from '@memberjunction/core';
+import { CalendarWatcher, ScheduledBridgeRunner, GraphCalendarSource, GraphCalendarClient, } from '@memberjunction/ai-bridge-server';
+/** The Teams bridge driver class — identities/bridges on this provider poll Graph + join via the Teams service. */
+const TEAMS_PROVIDER_DRIVER = 'TeamsBridge';
+/** Default cadence (ms) for the calendar sweep + due-bridge run. 60s balances freshness vs. API quota. */
+const DEFAULT_POLL_INTERVAL_MS = 60_000;
+/**
+ * Builds the {@link CalendarSourceResolver} that binds the real calendar clients per identity. Graph
+ * (Teams/Microsoft) identities bind a {@link GraphCalendarClient} authenticated with the bot's
+ * pre-resolved Graph token; any identity without configured credentials resolves to `null` and is
+ * skipped this sweep (the watcher tolerates that). Google binding activates when a Google auth client
+ * is wired into the deployment (none configured today → Google-backed identities are skipped).
+ */
+export function buildCalendarSourceResolver(teamsConfig) {
+    return (_identity, provider) => {
+        const driver = provider?.DriverClass?.trim();
+        if (driver === TEAMS_PROVIDER_DRIVER && teamsConfig.botAccessToken) {
+            return new GraphCalendarSource(new GraphCalendarClient({ Credentials: { AccessToken: teamsConfig.botAccessToken } }));
+        }
+        // Google Calendar is a deliberate, CLOSED seam — intentionally not bound here. The
+        // GoogleCalendarClient is built + unit-tested, but binding it would be dead code today:
+        //   1. there is no Google Meet *join* path for a detected invite to trigger (the scheduled-join
+        //      factory is Teams-only), and
+        //   2. Google's Meet Media API is Developer-Preview + allowlist-gated regardless (every meeting
+        //      participant must be enrolled), so it isn't a shippable target.
+        // To activate: define a Google auth client from config AND wire a Google Meet join. Until then
+        // Google identities are skipped rather than erroring the sweep.
+        return null;
+    };
+}
+/**
+ * Builds the {@link ScheduledBridgeSessionFactory} that turns a due bridge into start params. Resolves
+ * the bridge's agent (via its `AIAgentSession`) and, for a Teams bridge, delegates to the shared
+ * {@link TeamsMeetingsService} so the scheduled join reuses the exact provider/session/bind-sdk path as
+ * an on-demand join. Returns `null` (skip) for a provider with no scheduled-join wiring yet, or when the
+ * bridge has no join address.
+ */
+export function buildScheduledSessionFactory(teamsService) {
+    return async (ctx) => {
+        const joinUrl = ctx.BridgeRow.Address?.trim();
+        if (!joinUrl) {
+            LogStatus(`[CalendarScheduler] bridge ${ctx.BridgeRow.ID} has no join address; skipping.`);
+            return null;
+        }
+        if (ctx.Provider.DriverClass?.trim() !== TEAMS_PROVIDER_DRIVER) {
+            LogStatus(`[CalendarScheduler] no scheduled-join wiring for provider '${ctx.Provider.Name}'; skipping bridge ${ctx.BridgeRow.ID}.`);
+            return null;
+        }
+        const agentID = await resolveAgentID(ctx.BridgeRow.AgentSessionID, ctx.ContextUser, ctx.MetadataProvider);
+        if (!agentID) {
+            LogStatus(`[CalendarScheduler] could not resolve agent for session ${ctx.BridgeRow.AgentSessionID}; skipping.`);
+            return null;
+        }
+        const params = await teamsService.BuildScheduledStartParams({
+            agentID,
+            joinUrl,
+            agentSessionID: ctx.BridgeRow.AgentSessionID,
+            contextUser: ctx.ContextUser,
+            provider: ctx.MetadataProvider,
+        });
+        return params;
+    };
+}
+/** Loads the `AIAgentSession` to resolve the agent the scheduled bridge belongs to. */
+async function resolveAgentID(agentSessionID, contextUser, provider) {
+    const session = await provider.GetEntityObject('MJ: AI Agent Sessions', contextUser);
+    if (!(await session.Load(agentSessionID))) {
+        return null;
+    }
+    return session.AgentID;
+}
+/**
+ * Starts the calendar/scheduled-bridge loop: sweeps calendars and runs due bridges once immediately,
+ * then on a fixed interval. Mirrors {@link SessionJanitor.Start}. A sweep/run failure is logged and the
+ * loop continues — a transient calendar/transport error never kills the scheduler.
+ */
+export function StartCalendarScheduler(options) {
+    const watcher = new CalendarWatcher({
+        SourceResolver: buildCalendarSourceResolver(options.TeamsConfig),
+        ContextUser: options.ContextUser,
+        MetadataProvider: options.Provider,
+    });
+    const runner = new ScheduledBridgeRunner({
+        SessionFactory: buildScheduledSessionFactory(options.TeamsService),
+        ContextUser: options.ContextUser,
+        MetadataProvider: options.Provider,
+    });
+    const tick = async () => {
+        try {
+            const swept = await watcher.Sweep();
+            const ran = await runner.RunDueBridges();
+            if (swept.BridgesCreated > 0 || ran.Started > 0) {
+                LogStatus(`[CalendarScheduler] swept ${swept.BridgesCreated} new bridge(s); started ${ran.Started} due bridge(s).`);
+            }
+        }
+        catch (err) {
+            LogError(`[CalendarScheduler] sweep/run pass failed (continuing): ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+    void tick(); // run-once at boot
+    const timer = setInterval(() => void tick(), options.PollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
+    // Don't let the poll timer keep the process alive at shutdown (the loop is best-effort background work).
+    timer.unref?.();
+    LogStatus(`[CalendarScheduler] started (every ${(options.PollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS) / 1000}s).`);
+    return {
+        Stop() {
+            clearInterval(timer);
+        },
+    };
+}
+//# sourceMappingURL=calendar-scheduler.js.map

package/dist/telephony/calendar-scheduler.js.map

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

package/dist/telephony/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Public exports for the MJAPI telephony + meetings ingress.
+ *
+ * Each vendor ingress is a quartet: a per-call media registry, a bridge-orchestration service, an
+ * Express/WSS router (the `create*Handler` factory + mount-path consts), and a process-wide runtime
+ * holder (`Set*`/`Get*`). The routers + runtimes are star-exported; the service + registry modules are
+ * re-exported by name to avoid star-export ambiguity on their internal, per-vendor-identical helper
+ * types (`InboundCallInput`, `InboundCallResult`, `ITelephonyMediaSocket`). Those internal types are
+ * not part of the package's public surface — code that needs them imports from the source module.
+ *
+ * @module @memberjunction/server/telephony
+ */
+export * from './media-upgrade-router.js';
+export { TwilioCallMediaRegistry } from './twilioMediaRegistry.js';
+export { TwilioTelephonyService, type TwilioTelephonyServiceDeps } from './TwilioTelephonyService.js';
+export * from './TwilioTelephonyRouter.js';
+export * from './telephony-runtime.js';
+export { VonageCallMediaRegistry } from './vonageMediaRegistry.js';
+export { VonageTelephonyService, type VonageTelephonyServiceDeps } from './VonageTelephonyService.js';
+export * from './VonageTelephonyRouter.js';
+export * from './vonage-runtime.js';
+export { RingCentralTelephonyService, type RingCentralTelephonyServiceDeps } from './RingCentralTelephonyService.js';
+export * from './ringcentral-runtime.js';
+export * from './teamsAcsMediaRegistry.js';
+export * from './TeamsMeetingsService.js';
+export * from './TeamsMeetingsRouter.js';
+export * from './teams-meetings-runtime.js';
+export * from './calendar-scheduler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/telephony/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telephony/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,2BAA2B,CAAC;AAG1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,KAAK,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACtG,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,KAAK,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACtG,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AAMpC,OAAO,EAAE,2BAA2B,EAAE,KAAK,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACrH,cAAc,0BAA0B,CAAC;AAGzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,yBAAyB,CAAC"}

package/dist/telephony/index.js

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Public exports for the MJAPI telephony + meetings ingress.
+ *
+ * Each vendor ingress is a quartet: a per-call media registry, a bridge-orchestration service, an
+ * Express/WSS router (the `create*Handler` factory + mount-path consts), and a process-wide runtime
+ * holder (`Set*`/`Get*`). The routers + runtimes are star-exported; the service + registry modules are
+ * re-exported by name to avoid star-export ambiguity on their internal, per-vendor-identical helper
+ * types (`InboundCallInput`, `InboundCallResult`, `ITelephonyMediaSocket`). Those internal types are
+ * not part of the package's public surface — code that needs them imports from the source module.
+ *
+ * @module @memberjunction/server/telephony
+ */
+// ── Shared WebSocket-upgrade dispatcher (routes GraphQL + all media sockets by path) ──────
+export * from './media-upgrade-router.js';
+// ── Twilio Programmable Voice + Media Streams ──────────────────────────────────────────
+export { TwilioCallMediaRegistry } from './twilioMediaRegistry.js';
+export { TwilioTelephonyService } from './TwilioTelephonyService.js';
+export * from './TwilioTelephonyRouter.js';
+export * from './telephony-runtime.js';
+// ── Vonage Voice + WebSocket-media ─────────────────────────────────────────────────────
+export { VonageCallMediaRegistry } from './vonageMediaRegistry.js';
+export { VonageTelephonyService } from './VonageTelephonyService.js';
+export * from './VonageTelephonyRouter.js';
+export * from './vonage-runtime.js';
+// ── RingCentral SIP softphone (the only RingCentral transport with bidirectional call audio) ──
+// No media registry / webhook router: the softphone is an outbound SIP registration that receives inbound
+// INVITEs directly. The service owns the registration; the runtime holder shares it with the outbound
+// PlaceRingCentralCall resolver.
+export { RingCentralTelephonyService } from './RingCentralTelephonyService.js';
+export * from './ringcentral-runtime.js';
+// ── Teams meetings (Microsoft Graph cloud-communications + ACS application-hosted media) ──
+export * from './teamsAcsMediaRegistry.js';
+export * from './TeamsMeetingsService.js';
+export * from './TeamsMeetingsRouter.js';
+export * from './teams-meetings-runtime.js';
+// ── Scheduled / invite-driven meeting join loop (M2: calendar watcher + due-bridge runner) ──
+export * from './calendar-scheduler.js';
+//# sourceMappingURL=index.js.map

package/dist/telephony/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telephony/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,6FAA6F;AAC7F,cAAc,2BAA2B,CAAC;AAE1C,0FAA0F;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAmC,MAAM,6BAA6B,CAAC;AACtG,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AAEvC,0FAA0F;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAmC,MAAM,6BAA6B,CAAC;AACtG,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AAEpC,iGAAiG;AACjG,0GAA0G;AAC1G,sGAAsG;AACtG,iCAAiC;AACjC,OAAO,EAAE,2BAA2B,EAAwC,MAAM,kCAAkC,CAAC;AACrH,cAAc,0BAA0B,CAAC;AAEzC,6FAA6F;AAC7F,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAE5C,+FAA+F;AAC/F,cAAc,yBAAyB,CAAC"}

package/dist/telephony/media-upgrade-router.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Single WebSocket-upgrade dispatcher for the shared HTTP server.
+ *
+ * Why this exists: in `ws` 8.x, every `new WebSocketServer({ server })` attaches its OWN `upgrade`
+ * listener that calls `handleUpgrade` UNCONDITIONALLY, and `handleUpgrade` does `abortHandshake(400)` for
+ * any request whose path it doesn't own. So two `{server}`-bound servers on one HTTP server (e.g. the
+ * GraphQL subscriptions socket on `/` AND a telephony Media-Streams socket on `/telephony/.../media`)
+ * fight on every upgrade — the non-owning server 400s the request. That's exactly what made Twilio's
+ * `<Connect><Stream>` fail with error 31920 ("Stream WebSocket failed to connect").
+ *
+ * The fix: telephony/meetings media servers are created with `{ noServer: true }` (no auto-listener) and
+ * register their path here; at boot we strip the auto-listeners and install ONE `upgrade` listener that
+ * routes by path — GraphQL on its root path, each media socket on its own. When no media routes are
+ * registered (telephony disabled), we leave the GraphQL server's own listener untouched (zero change).
+ *
+ * @module @memberjunction/server/telephony
+ */
+import type { Server as HttpServer } from 'node:http';
+import type { WebSocketServer } from 'ws';
+/** Registers a media WebSocket route. Called by each vendor router's attach step. */
+export declare function RegisterMediaUpgradeRoute(path: string, wss: WebSocketServer): void;
+/**
+ * Installs the single path-routing `upgrade` dispatcher. No-op when no media routes are registered, so
+ * the GraphQL server keeps its own listener untouched. Otherwise it removes the auto-attached listeners
+ * (GraphQL's included) and dispatches every upgrade by pathname — GraphQL on `graphqlPath`, each media
+ * socket on its registered path; unknown paths are destroyed.
+ *
+ * @param httpServer  the shared HTTP server.
+ * @param graphqlWss  the GraphQL subscriptions WebSocketServer (kept, re-dispatched on its path).
+ * @param graphqlPath the GraphQL root path (the path GraphQL's socket listens on).
+ */
+export declare function InstallMediaUpgradeDispatcher(httpServer: HttpServer, graphqlWss: WebSocketServer, graphqlPath: string): void;
+//# sourceMappingURL=media-upgrade-router.d.ts.map

package/dist/telephony/media-upgrade-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-upgrade-router.d.ts","sourceRoot":"","sources":["../../src/telephony/media-upgrade-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAmB,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAK1C,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAElF;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAqB5H"}

package/dist/telephony/media-upgrade-router.js

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Single WebSocket-upgrade dispatcher for the shared HTTP server.
+ *
+ * Why this exists: in `ws` 8.x, every `new WebSocketServer({ server })` attaches its OWN `upgrade`
+ * listener that calls `handleUpgrade` UNCONDITIONALLY, and `handleUpgrade` does `abortHandshake(400)` for
+ * any request whose path it doesn't own. So two `{server}`-bound servers on one HTTP server (e.g. the
+ * GraphQL subscriptions socket on `/` AND a telephony Media-Streams socket on `/telephony/.../media`)
+ * fight on every upgrade — the non-owning server 400s the request. That's exactly what made Twilio's
+ * `<Connect><Stream>` fail with error 31920 ("Stream WebSocket failed to connect").
+ *
+ * The fix: telephony/meetings media servers are created with `{ noServer: true }` (no auto-listener) and
+ * register their path here; at boot we strip the auto-listeners and install ONE `upgrade` listener that
+ * routes by path — GraphQL on its root path, each media socket on its own. When no media routes are
+ * registered (telephony disabled), we leave the GraphQL server's own listener untouched (zero change).
+ *
+ * @module @memberjunction/server/telephony
+ */
+/** path → the `{ noServer:true }` WebSocketServer that owns it. */
+const mediaRoutes = new Map();
+/** Registers a media WebSocket route. Called by each vendor router's attach step. */
+export function RegisterMediaUpgradeRoute(path, wss) {
+    mediaRoutes.set(path, wss);
+}
+/**
+ * Installs the single path-routing `upgrade` dispatcher. No-op when no media routes are registered, so
+ * the GraphQL server keeps its own listener untouched. Otherwise it removes the auto-attached listeners
+ * (GraphQL's included) and dispatches every upgrade by pathname — GraphQL on `graphqlPath`, each media
+ * socket on its registered path; unknown paths are destroyed.
+ *
+ * @param httpServer  the shared HTTP server.
+ * @param graphqlWss  the GraphQL subscriptions WebSocketServer (kept, re-dispatched on its path).
+ * @param graphqlPath the GraphQL root path (the path GraphQL's socket listens on).
+ */
+export function InstallMediaUpgradeDispatcher(httpServer, graphqlWss, graphqlPath) {
+    if (mediaRoutes.size === 0) {
+        return;
+    }
+    httpServer.removeAllListeners('upgrade');
+    const dispatch = (wss, req, socket, head) => {
+        wss.handleUpgrade(req, socket, head, (ws) => wss.emit('connection', ws, req));
+    };
+    httpServer.on('upgrade', (req, socket, head) => {
+        const pathname = (req.url ?? '').split('?')[0];
+        if (pathname === graphqlPath) {
+            dispatch(graphqlWss, req, socket, head);
+            return;
+        }
+        const wss = mediaRoutes.get(pathname);
+        if (wss) {
+            dispatch(wss, req, socket, head);
+            return;
+        }
+        socket.destroy();
+    });
+}
+//# sourceMappingURL=media-upgrade-router.js.map

package/dist/telephony/media-upgrade-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-upgrade-router.js","sourceRoot":"","sources":["../../src/telephony/media-upgrade-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,mEAAmE;AACnE,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEvD,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,GAAoB;IACxE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAAC,UAAsB,EAAE,UAA2B,EAAE,WAAmB;IAClH,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACX,CAAC;IACD,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,CAAC,GAAoB,EAAE,GAAoB,EAAE,MAAc,EAAE,IAAY,EAAQ,EAAE;QAChG,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC;IACF,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAoB,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE;QAC5E,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3B,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACxC,OAAO;QACX,CAAC;QACD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,CAAC;YACN,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO;QACX,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/telephony/ringcentral-runtime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed RingCentral telephony service, so the
+ * outbound `PlaceRingCentralCall` GraphQL resolver reaches the SAME {@link RingCentralTelephonyService}
+ * (and thus the same long-lived SIP-softphone registration) that the inbound INVITE coordinator uses. Set
+ * once during server boot; read by the resolver.
+ *
+ * @module @memberjunction/server/telephony
+ */
+import type { RingCentralTelephonyService } from './RingCentralTelephonyService.js';
+/** Binds the startup-constructed RingCentral telephony service (called from server boot). */
+export declare function SetRingCentralTelephonyService(service: RingCentralTelephonyService): void;
+/** Returns the bound RingCentral telephony service, or `undefined` when telephony is not configured. */
+export declare function GetRingCentralTelephonyService(): RingCentralTelephonyService | undefined;
+//# sourceMappingURL=ringcentral-runtime.d.ts.map

package/dist/telephony/ringcentral-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ringcentral-runtime.d.ts","sourceRoot":"","sources":["../../src/telephony/ringcentral-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAIpF,6FAA6F;AAC7F,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAEzF;AAED,wGAAwG;AACxG,wBAAgB,8BAA8B,IAAI,2BAA2B,GAAG,SAAS,CAExF"}

package/dist/telephony/ringcentral-runtime.js

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed RingCentral telephony service, so the
+ * outbound `PlaceRingCentralCall` GraphQL resolver reaches the SAME {@link RingCentralTelephonyService}
+ * (and thus the same long-lived SIP-softphone registration) that the inbound INVITE coordinator uses. Set
+ * once during server boot; read by the resolver.
+ *
+ * @module @memberjunction/server/telephony
+ */
+let ringCentralService;
+/** Binds the startup-constructed RingCentral telephony service (called from server boot). */
+export function SetRingCentralTelephonyService(service) {
+    ringCentralService = service;
+}
+/** Returns the bound RingCentral telephony service, or `undefined` when telephony is not configured. */
+export function GetRingCentralTelephonyService() {
+    return ringCentralService;
+}
+//# sourceMappingURL=ringcentral-runtime.js.map