@memberjunction/server 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/sharedCache.js

@@ -0,0 +1,276 @@
+/**
+ * Everything an MJAPI process does with its shared (Redis) connection: which provider to build,
+ * what it publishes, what it does with events from other servers, and which periodic jobs the
+ * connection's leases coordinate.
+ *
+ * Two independent consumers share the one connection and its one subscriber:
+ * {@link WireSharedCacheEvents} for cache invalidation, and {@link WirePushStatusFanOut} for
+ * cross-instance push-status delivery (MJ #4222). Both live here rather than at the call site so
+ * that "what is our Redis used for" has a single answer.
+ *
+ */
+import { BaseEngineSweeper, CacheCategory, LocalCacheManager, LogError, LogStatusEx } from '@memberjunction/core';
+import { RedisLocalStorageProvider } from '@memberjunction/redis-provider';
+import { MJGlobal } from '@memberjunction/global';
+import { PubSubManager } from './generic/PubSubManager.js';
+import { PUSH_STATUS_UPDATES_TOPIC, SetPushStatusPublishHook, ParseReplicatedStatusUpdate } from './generic/PushStatusResolver.js';
+import { CACHE_INVALIDATION_TOPIC } from './generic/CacheInvalidationResolver.js';
+import { UserCache } from '@memberjunction/generic-database-provider';
+/**
+ * What an MJAPI process publishes, per category.
+ *
+ * - RunView slots carry their rows: engines on other servers apply them directly.
+ * - Writes without a category (the provider's metadata snapshot, ~2 MB compressed) publish a
+ *   notice only: other servers re-check their metadata against the database and adopt the shared
+ *   snapshot, so the value never needs to travel.
+ * - Everything else (dataset slots, query slots, registry) has no subscriber and publishes nothing.
+ * Category clears are always published.
+ */
+export const MJAPI_PUBLISH_MODES = {
+    [CacheCategory.RunViewCache]: 'full',
+    [CacheCategory.Default]: 'notice',
+};
+/**
+ * Expiry for the shared Redis cache: `REDIS_TTL_SECONDS` when it holds a non-negative integer,
+ * otherwise `cacheSettings.sharedCacheTTLSeconds`, otherwise `undefined` (the provider's default).
+ */
+export function ResolveSharedCacheTTLSeconds(configured, env = process.env) {
+    const fromEnv = env.REDIS_TTL_SECONDS;
+    if (fromEnv !== undefined && fromEnv.trim() !== '') {
+        const parsed = Number(fromEnv);
+        if (Number.isInteger(parsed) && parsed >= 0) {
+            return parsed;
+        }
+        console.warn(`REDIS_TTL_SECONDS="${fromEnv}" is not a non-negative integer; ignoring it`);
+    }
+    return configured;
+}
+/**
+ * The shared cache the environment asks for (`REDIS_URL`, `REDIS_KEY_PREFIX`, `REDIS_TTL_SECONDS`),
+ * or null. Built before the database provider so metadata and startup engines use it from the
+ * first read.
+ */
+export function CreateSharedCacheFromEnvironment(settings, env = process.env) {
+    if (!env.REDIS_URL) {
+        return null;
+    }
+    return CreateSharedCacheProvider({
+        Url: env.REDIS_URL,
+        KeyPrefix: env.REDIS_KEY_PREFIX || 'mj',
+        DefaultTTLSeconds: ResolveSharedCacheTTLSeconds(settings?.sharedCacheTTLSeconds, env),
+        EnableLogging: settings?.verboseLogging ?? false,
+    });
+}
+/**
+ * The warm-up lease MJAPI hands to `StartupManager`, in milliseconds, from
+ * `cacheSettings.startupWarmupLeaseSeconds` (default 30).
+ */
+export function WarmupLeaseMsFromSettings(settings) {
+    return (settings?.startupWarmupLeaseSeconds ?? 30) * 1000;
+}
+/** `LocalCacheManager` settings from `cacheSettings` in mj.config.cjs. */
+export function CacheManagerConfigFromSettings(settings) {
+    return {
+        maxSizeBytes: (settings?.maxMemoryMB ?? 150) * 1024 * 1024,
+        maxPercentOfCachePerEntity: settings?.maxPercentOfCachePerEntity ?? 50,
+        defaultTTLMs: (settings?.defaultTTLSeconds ?? 0) * 1000,
+        evictionSweepIntervalMs: (settings?.evictionSweepIntervalSeconds ?? 300) * 1000,
+        verboseLogging: settings?.verboseLogging ?? false,
+    };
+}
+/**
+ * Starts the periodic engine-vs-database sweep (plan Phase 3.1) at
+ * `cacheSettings.engineSweepIntervalSeconds` (default 300; 0 leaves it off).
+ * @returns The interval in milliseconds, 0 when disabled.
+ */
+export function StartEngineSweeper(settings) {
+    const intervalMs = (settings?.engineSweepIntervalSeconds ?? 300) * 1000;
+    BaseEngineSweeper.Instance.Start(intervalMs);
+    return intervalMs;
+}
+/** The periodic metadata sweep, so a restart or a config change can replace it. @internal */
+let metadataSweepTimer = null;
+/**
+ * Starts the periodic metadata-vs-database sweep at `cacheSettings.metadataSweepIntervalSeconds`
+ * (default 300; 0 leaves it off).
+ *
+ * The sweep asks the database **nothing** unless one of the entities the metadata is built from
+ * declares `TrustServerCacheCompletely = false` — see `ProviderBase.SweepMetadataAgainstDatabase`.
+ * On a stock installation no metadata entity declares it, so the timer ticks and costs nothing. It
+ * exists for installations that write metadata tables directly, where no event is ever raised and
+ * nothing else would notice.
+ *
+ * One process per interval does the work, via a shared lease: a process that refreshes writes a new
+ * snapshot and publishes a notice, which the others act on, so there is no value in each of them
+ * asking the database the same question.
+ *
+ * @returns The interval in milliseconds, 0 when disabled.
+ */
+export function StartMetadataSweep(settings, metadataProvider) {
+    if (metadataSweepTimer) {
+        clearInterval(metadataSweepTimer);
+        metadataSweepTimer = null;
+    }
+    const intervalMs = (settings?.metadataSweepIntervalSeconds ?? 300) * 1000;
+    if (intervalMs <= 0) {
+        return 0;
+    }
+    const leaseMs = Math.max(5_000, intervalMs - 5_000);
+    const timer = setInterval(() => void runMetadataSweep(metadataProvider(), leaseMs), intervalMs);
+    if (typeof timer === 'object' && timer !== null && 'unref' in timer) {
+        timer.unref();
+    }
+    metadataSweepTimer = timer;
+    return intervalMs;
+}
+/** One sweep: take the fleet lease only when there is something to check. @internal */
+async function runMetadataSweep(provider, leaseMs) {
+    if (!provider) {
+        return;
+    }
+    try {
+        // The lease is taken only when an entity declares drift, so a stock installation costs no
+        // Redis round trip either — the provider answers from its own membership set.
+        const declared = provider.MetadataMembersDeclaringDrift();
+        if (declared.length === 0) {
+            return;
+        }
+        if (!(await LocalCacheManager.Instance.TryAcquireSharedLease('metadata-sweep', leaseMs))) {
+            return;
+        }
+        const result = await provider.SweepMetadataAgainstDatabase();
+        if (result.Refreshed) {
+            LogStatusEx({ message: `[MJAPI] metadata sweep reloaded metadata; entities declaring drift: ${result.Declared.join(', ')}`, verboseOnly: false });
+        }
+    }
+    catch (e) {
+        LogError(`[MJAPI] metadata sweep failed: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+/**
+ * Starts the periodic user-cache staleness check at `cacheSettings.userCacheCheckIntervalSeconds`
+ * (default 300; 0 leaves it off). The cache refreshes on MJ writes by itself — this covers users
+ * and roles changed outside MJ.
+ * @returns The interval in milliseconds, 0 when disabled.
+ */
+export function StartUserCacheChecks(settings) {
+    const intervalMs = (settings?.userCacheCheckIntervalSeconds ?? 300) * 1000;
+    UserCache.Instance.StartStalenessChecks(intervalMs);
+    return intervalMs;
+}
+/** Builds the Redis provider MJAPI uses as its shared cache. Pub/sub starts with {@link WireSharedCacheEvents}. */
+export function CreateSharedCacheProvider(options) {
+    // The provider's own config keys stay as the package declares them.
+    return new RedisLocalStorageProvider({
+        url: options.Url,
+        keyPrefix: options.KeyPrefix,
+        defaultTTLSeconds: options.DefaultTTLSeconds,
+        enablePubSub: true,
+        enableLogging: options.EnableLogging,
+        publishModes: MJAPI_PUBLISH_MODES,
+        defaultPublishMode: 'none',
+    });
+}
+/**
+ * Subscribes to other servers' cache events and routes them. Called before the database provider
+ * exists (so engines hear peers while they load); `metadataProvider` is resolved per event.
+ * 1. a metadata-snapshot notice → a metadata staleness check on this process's provider, and
+ *    nothing further (a consumed notice returns here);
+ * 2. every other event → `LocalCacheManager.DispatchCacheChange` (engines, the user cache, and
+ *    RunView callbacks);
+ * 3. RunView slot changes → an entity-level invalidation to connected browsers.
+ */
+export async function WireSharedCacheEvents(redis, metadataProvider) {
+    await redis.StartListening();
+    redis.OnCacheChanged((event) => RouteSharedCacheEvent(event, metadataProvider()));
+}
+/** One incoming event, routed as described on {@link WireSharedCacheEvents}. */
+export function RouteSharedCacheEvent(event, metadataProvider) {
+    const source = event.SourceServerId ? event.SourceServerId.substring(0, 8) : 'unknown';
+    LogStatusEx({ message: `[MJAPI] shared cache event: ${event.Category}/${event.Action} "${event.CacheKey}" from ${source}`, verboseOnly: true });
+    if (metadataProvider?.HandlePeerMetadataNotice(event)) {
+        return;
+    }
+    LocalCacheManager.Instance.DispatchCacheChange(event);
+    relayRunViewChangeToBrowsers(event);
+}
+/**
+ * Browsers only care about entity data. A RunView slot key starts with the entity name
+ * (`Entity|Filter|…`); other categories' keys are not entity names and used to reach browsers as
+ * invalidations for "entities" such as `___MJCore_Metadata_AllMetadata`.
+ */
+function relayRunViewChangeToBrowsers(event) {
+    if (event.Category !== CacheCategory.RunViewCache || event.Action === 'category_cleared') {
+        return;
+    }
+    const entityName = event.CacheKey ? event.CacheKey.split('|')[0] : '';
+    if (!entityName) {
+        return;
+    }
+    PubSubManager.Instance.Publish(CACHE_INVALIDATION_TOPIC, {
+        entityName,
+        primaryKeyValues: null, // entity-level invalidation
+        action: event.Action,
+        sourceServerId: event.SourceServerId || 'unknown',
+        timestamp: new Date(),
+    });
+}
+/** Redis channel carrying replicated push-status updates between server instances. */
+const PUSH_STATUS_FANOUT_CHANNEL = 'push-status-updates';
+/**
+ * Replicate push-status updates across server instances over Redis (MJ #4222).
+ *
+ * Outbound: every locally-published update is forwarded on a shared channel. Inbound: a message
+ * from another instance is republished onto THIS instance's local topic, where the normal
+ * subscription filter decides who receives it — so the identity gate (`ownerUserId` vs. the
+ * connection's authenticated user) still applies to a replicated message exactly as it does to a
+ * local one. The replica has no say in who sees what.
+ *
+ * Republishing goes straight to `PubSubManager`, never back through `publishStatusUpdate`, so an
+ * inbound message cannot be re-broadcast and loop. `SourceServerId` guards the remaining case: a
+ * publisher also receives its own message from Redis.
+ *
+ * The channel rides the same connection and subscriber as cache invalidation, and is namespaced
+ * with the provider's key prefix — so replicas configured with different `REDIS_KEY_PREFIX`
+ * values stop replicating to each other, exactly as their caches do.
+ *
+ * @param redis The shared cache provider, already built by {@link CreateSharedCacheFromEnvironment}.
+ */
+export async function WirePushStatusFanOut(redis) {
+    try {
+        await redis.SubscribeToChannel(PUSH_STATUS_FANOUT_CHANNEL, (raw) => {
+            try {
+                const payload = ParseReplicatedStatusUpdate(raw, MJGlobal.Instance.ProcessUUID);
+                if (!payload) {
+                    return;
+                }
+                // Rebuilt as a plain record: the topic's publish signature takes an index-signature
+                // type, and listing the fields keeps the wire shape explicit at the one place it
+                // crosses hosts.
+                PubSubManager.Instance.Publish(PUSH_STATUS_UPDATES_TOPIC, {
+                    sessionId: payload.sessionId,
+                    ownerUserId: payload.ownerUserId,
+                    message: payload.message,
+                    SourceServerId: payload.SourceServerId,
+                });
+            }
+            catch (err) {
+                // A malformed message on a shared channel must not take down the subscriber.
+                LogError('Error processing push-status fan-out message', undefined, err);
+            }
+        });
+        SetPushStatusPublishHook((payload) => {
+            redis.PublishMessage(PUSH_STATUS_FANOUT_CHANNEL, JSON.stringify(payload));
+        });
+        // Printed unconditionally, not verbose-gated. "Is fan-out actually on?" is the first
+        // question anyone debugging a hung conversation behind a load balancer asks, and a silent
+        // default left no way to answer it.
+        console.log('[MJAPI] Push-status updates: cross-instance fan-out enabled via Redis');
+    }
+    catch (err) {
+        // Single-instance delivery still works, and the durable tail query covers the rest.
+        // Degraded, not broken — so this must not stop the server from starting.
+        console.warn(`Push-status fan-out unavailable: ${err.message}`);
+    }
+}
+//# sourceMappingURL=sharedCache.js.map

package/dist/sharedCache.js.map

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

package/dist/types.d.ts

@@ -48,6 +48,12 @@ export type AppContext = {
      * Per-request DatabaseProviderBase instances
      */
     providers: Array<ProviderInfo>;
+    /**
+     * The caller's network address as Express resolved it (`req.ip`, which honours the app's
+     * `trust proxy` setting). Present for HTTP requests; absent on WebSocket (subscription) contexts.
+     * Used only to key abuse limits (e.g. realtime verification sends) — never as an identity.
+     */
+    ClientIp?: string;
 };
 export declare class ProviderInfo {
     provider: DatabaseProviderBase;
@@ -110,6 +116,11 @@ export type RunViewGenericParams = {
      * Propagated to `RunViewParams.DataSource`.
      */
     dataSource?: 'Live' | 'Materialized';
+    /**
+     * When true, binary fields (`varbinary` / `bytea`, as base64 strings) are returned.
+     * Propagated to `RunViewParams.IncludeBinaryFields`.
+     */
+    includeBinaryFields?: boolean;
 };
 export declare class MJServerEvent {
     type: 'setupComplete' | 'requestReceived' | 'requestCompleted' | 'requestFailed';

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAqDxE,MAAM,OAAO,YAAY;CAGxB;AAED,MAAM,OAAO,cAAc;IASzB,YAAY,IAA4J;QACtK,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF;AAAA,CAAC;AA8CF,MAAM,OAAO,aAAa;CAKzB;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAA2B,EAAE,WAA6B,EAAE,WAAwB,EAAE,SAAe;IACpI,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;IAEzC,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;IAC1B,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC;IACjB,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,cAAc,CAAC;IACvC,GAAG,CAAC,SAAS,GAAG,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAA2B,EAAE,WAA6B,EAAE,WAAwB,EAAE,SAAe;IACpI,OAAO,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AA4DxE,MAAM,OAAO,YAAY;CAGxB;AAED,MAAM,OAAO,cAAc;IASzB,YAAY,IAA4J;QACtK,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF;AAAA,CAAC;AAmDF,MAAM,OAAO,aAAa;CAKzB;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAA2B,EAAE,WAA6B,EAAE,WAAwB,EAAE,SAAe;IACpI,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;IAEzC,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;IAC1B,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC;IACjB,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,cAAc,CAAC;IACvC,GAAG,CAAC,SAAS,GAAG,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAA2B,EAAE,WAA6B,EAAE,WAAwB,EAAE,SAAe;IACpI,OAAO,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/server",
-  "version": "6.2.0-edge.2",
+  "version": "6.2.0-edge.4",
   "description": "MemberJunction: This project provides API access via GraphQL to the common data store.",
   "main": "./dist/index.js",
   "types": "./src/index.ts",
@@ -19,98 +19,101 @@
     "@as-integrations/express5": "^1.0.0",
     "@graphql-tools/schema": "^10.0.38",
     "@graphql-tools/utils": "^11.0.0",
-    "@memberjunction/actions": "6.2.0-edge.2",
-    "@memberjunction/actions-apollo": "6.2.0-edge.2",
-    "@memberjunction/actions-base": "6.2.0-edge.2",
-    "@memberjunction/actions-bizapps-accounting": "6.2.0-edge.2",
-    "@memberjunction/actions-bizapps-crm": "6.2.0-edge.2",
-    "@memberjunction/actions-bizapps-formbuilders": "6.2.0-edge.2",
-    "@memberjunction/actions-bizapps-lms": "6.2.0-edge.2",
-    "@memberjunction/actions-bizapps-social": "6.2.0-edge.2",
-    "@memberjunction/ai": "6.2.0-edge.2",
-    "@memberjunction/ai-agent-manager": "6.2.0-edge.2",
-    "@memberjunction/ai-agent-manager-actions": "6.2.0-edge.2",
-    "@memberjunction/ai-agents": "6.2.0-edge.2",
-    "@memberjunction/ai-bridge-base": "6.2.0-edge.2",
-    "@memberjunction/ai-bridge-ringcentral": "6.2.0-edge.2",
-    "@memberjunction/ai-bridge-server": "6.2.0-edge.2",
-    "@memberjunction/ai-bridge-teams": "6.2.0-edge.2",
-    "@memberjunction/ai-bridge-twilio": "6.2.0-edge.2",
-    "@memberjunction/ai-bridge-vonage": "6.2.0-edge.2",
-    "@memberjunction/ai-core-plus": "6.2.0-edge.2",
-    "@memberjunction/ai-engine-base": "6.2.0-edge.2",
-    "@memberjunction/ai-mcp-client": "6.2.0-edge.2",
-    "@memberjunction/ai-prompts": "6.2.0-edge.2",
-    "@memberjunction/ai-provider-bundle": "6.2.0-edge.2",
-    "@memberjunction/ai-vector-dupe": "6.2.0-edge.2",
-    "@memberjunction/ai-vector-sync": "6.2.0-edge.2",
-    "@memberjunction/ai-vectordb": "6.2.0-edge.2",
-    "@memberjunction/ai-vectors-pinecone": "6.2.0-edge.2",
-    "@memberjunction/aiengine": "6.2.0-edge.2",
-    "@memberjunction/api-keys": "6.2.0-edge.2",
-    "@memberjunction/auth-providers": "6.2.0-edge.2",
-    "@memberjunction/clustering-engine": "6.2.0-edge.2",
-    "@memberjunction/codegen-lib": "6.2.0-edge.2",
-    "@memberjunction/communication-engine": "6.2.0-edge.2",
-    "@memberjunction/communication-ms-graph": "6.2.0-edge.2",
-    "@memberjunction/communication-sendgrid": "6.2.0-edge.2",
-    "@memberjunction/communication-types": "6.2.0-edge.2",
-    "@memberjunction/component-registry-client-sdk": "6.2.0-edge.2",
-    "@memberjunction/computer-use": "6.2.0-edge.2",
-    "@memberjunction/computer-use-engine": "6.2.0-edge.2",
-    "@memberjunction/config": "6.2.0-edge.2",
-    "@memberjunction/core": "6.2.0-edge.2",
-    "@memberjunction/core-actions": "6.2.0-edge.2",
-    "@memberjunction/core-entities": "6.2.0-edge.2",
-    "@memberjunction/core-entities-server": "6.2.0-edge.2",
-    "@memberjunction/credentials": "6.2.0-edge.2",
-    "@memberjunction/data-context": "6.2.0-edge.2",
-    "@memberjunction/data-context-server": "6.2.0-edge.2",
-    "@memberjunction/doc-utils": "6.2.0-edge.2",
-    "@memberjunction/encryption": "6.2.0-edge.2",
-    "@memberjunction/entity-communications-base": "6.2.0-edge.2",
-    "@memberjunction/entity-communications-server": "6.2.0-edge.2",
-    "@memberjunction/esignature": "6.2.0-edge.2",
-    "@memberjunction/external-change-detection": "6.2.0-edge.2",
-    "@memberjunction/generic-database-provider": "6.2.0-edge.2",
-    "@memberjunction/global": "6.2.0-edge.2",
-    "@memberjunction/graphql-dataprovider": "6.2.0-edge.2",
-    "@memberjunction/integration-engine": "6.2.0-edge.2",
-    "@memberjunction/integration-engine-base": "6.2.0-edge.2",
-    "@memberjunction/integration-progress-artifacts": "6.2.0-edge.2",
-    "@memberjunction/integration-schema-builder": "6.2.0-edge.2",
-    "@memberjunction/interactive-component-types": "6.2.0-edge.2",
-    "@memberjunction/lists": "6.2.0-edge.2",
-    "@memberjunction/lists-base": "6.2.0-edge.2",
-    "@memberjunction/livekit-room-server": "6.2.0-edge.2",
-    "@memberjunction/network-utils": "6.2.0-edge.2",
-    "@memberjunction/notifications": "6.2.0-edge.2",
-    "@memberjunction/postgresql-dataprovider": "6.2.0-edge.2",
-    "@memberjunction/queue": "6.2.0-edge.2",
-    "@memberjunction/record-comparison": "6.2.0-edge.2",
-    "@memberjunction/redis-provider": "6.2.0-edge.2",
-    "@memberjunction/remote-browser-base": "6.2.0-edge.2",
-    "@memberjunction/remote-browser-cdp": "6.2.0-edge.2",
-    "@memberjunction/remote-browser-selfhost": "6.2.0-edge.2",
-    "@memberjunction/remote-browser-server": "6.2.0-edge.2",
-    "@memberjunction/scheduling-actions": "6.2.0-edge.2",
-    "@memberjunction/scheduling-base-types": "6.2.0-edge.2",
-    "@memberjunction/scheduling-engine": "6.2.0-edge.2",
-    "@memberjunction/scheduling-engine-base": "6.2.0-edge.2",
-    "@memberjunction/schema-engine": "6.2.0-edge.2",
-    "@memberjunction/search-engine": "6.2.0-edge.2",
-    "@memberjunction/server-extensions-core": "6.2.0-edge.2",
-    "@memberjunction/sql-dialect": "6.2.0-edge.2",
-    "@memberjunction/sql-parser": "6.2.0-edge.2",
-    "@memberjunction/sqlserver-dataprovider": "6.2.0-edge.2",
-    "@memberjunction/storage": "6.2.0-edge.2",
-    "@memberjunction/tag-engine": "6.2.0-edge.2",
-    "@memberjunction/tag-engine-base": "6.2.0-edge.2",
-    "@memberjunction/task-graph": "6.2.0-edge.2",
-    "@memberjunction/templates": "6.2.0-edge.2",
-    "@memberjunction/testing-engine": "6.2.0-edge.2",
-    "@memberjunction/testing-engine-base": "6.2.0-edge.2",
-    "@memberjunction/version-history": "6.2.0-edge.2",
+    "@memberjunction/actions": "6.2.0-edge.4",
+    "@memberjunction/actions-apollo": "6.2.0-edge.4",
+    "@memberjunction/actions-base": "6.2.0-edge.4",
+    "@memberjunction/actions-bizapps-accounting": "6.2.0-edge.4",
+    "@memberjunction/actions-bizapps-crm": "6.2.0-edge.4",
+    "@memberjunction/actions-bizapps-formbuilders": "6.2.0-edge.4",
+    "@memberjunction/actions-bizapps-lms": "6.2.0-edge.4",
+    "@memberjunction/actions-bizapps-social": "6.2.0-edge.4",
+    "@memberjunction/actions-peopledatalabs": "6.2.0-edge.4",
+    "@memberjunction/ai": "6.2.0-edge.4",
+    "@memberjunction/ai-agent-manager": "6.2.0-edge.4",
+    "@memberjunction/ai-agent-manager-actions": "6.2.0-edge.4",
+    "@memberjunction/ai-agents": "6.2.0-edge.4",
+    "@memberjunction/ai-bridge-base": "6.2.0-edge.4",
+    "@memberjunction/ai-bridge-ringcentral": "6.2.0-edge.4",
+    "@memberjunction/ai-bridge-server": "6.2.0-edge.4",
+    "@memberjunction/ai-bridge-teams": "6.2.0-edge.4",
+    "@memberjunction/ai-bridge-twilio": "6.2.0-edge.4",
+    "@memberjunction/ai-bridge-vonage": "6.2.0-edge.4",
+    "@memberjunction/ai-core-plus": "6.2.0-edge.4",
+    "@memberjunction/ai-engine-base": "6.2.0-edge.4",
+    "@memberjunction/ai-mcp-client": "6.2.0-edge.4",
+    "@memberjunction/ai-prompts": "6.2.0-edge.4",
+    "@memberjunction/ai-provider-bundle": "6.2.0-edge.4",
+    "@memberjunction/ai-vector-dupe": "6.2.0-edge.4",
+    "@memberjunction/ai-vector-sync": "6.2.0-edge.4",
+    "@memberjunction/ai-vectordb": "6.2.0-edge.4",
+    "@memberjunction/ai-vectors-pinecone": "6.2.0-edge.4",
+    "@memberjunction/aiengine": "6.2.0-edge.4",
+    "@memberjunction/api-keys": "6.2.0-edge.4",
+    "@memberjunction/auth-providers": "6.2.0-edge.4",
+    "@memberjunction/clustering-engine": "6.2.0-edge.4",
+    "@memberjunction/codegen-lib": "6.2.0-edge.4",
+    "@memberjunction/communication-engine": "6.2.0-edge.4",
+    "@memberjunction/communication-ms-graph": "6.2.0-edge.4",
+    "@memberjunction/communication-sendgrid": "6.2.0-edge.4",
+    "@memberjunction/communication-types": "6.2.0-edge.4",
+    "@memberjunction/component-registry-client-sdk": "6.2.0-edge.4",
+    "@memberjunction/computer-use": "6.2.0-edge.4",
+    "@memberjunction/computer-use-engine": "6.2.0-edge.4",
+    "@memberjunction/config": "6.2.0-edge.4",
+    "@memberjunction/core": "6.2.0-edge.4",
+    "@memberjunction/core-actions": "6.2.0-edge.4",
+    "@memberjunction/core-entities": "6.2.0-edge.4",
+    "@memberjunction/core-entities-server": "6.2.0-edge.4",
+    "@memberjunction/credentials": "6.2.0-edge.4",
+    "@memberjunction/data-context": "6.2.0-edge.4",
+    "@memberjunction/data-context-server": "6.2.0-edge.4",
+    "@memberjunction/doc-utils": "6.2.0-edge.4",
+    "@memberjunction/encryption": "6.2.0-edge.4",
+    "@memberjunction/entity-communications-base": "6.2.0-edge.4",
+    "@memberjunction/entity-communications-server": "6.2.0-edge.4",
+    "@memberjunction/esignature": "6.2.0-edge.4",
+    "@memberjunction/external-change-detection": "6.2.0-edge.4",
+    "@memberjunction/generic-database-provider": "6.2.0-edge.4",
+    "@memberjunction/global": "6.2.0-edge.4",
+    "@memberjunction/graphql-dataprovider": "6.2.0-edge.4",
+    "@memberjunction/integration-engine": "6.2.0-edge.4",
+    "@memberjunction/integration-engine-base": "6.2.0-edge.4",
+    "@memberjunction/integration-progress-artifacts": "6.2.0-edge.4",
+    "@memberjunction/integration-schema-builder": "6.2.0-edge.4",
+    "@memberjunction/interactive-component-types": "6.2.0-edge.4",
+    "@memberjunction/lists": "6.2.0-edge.4",
+    "@memberjunction/lists-base": "6.2.0-edge.4",
+    "@memberjunction/livekit-room-server": "6.2.0-edge.4",
+    "@memberjunction/network-utils": "6.2.0-edge.4",
+    "@memberjunction/notifications": "6.2.0-edge.4",
+    "@memberjunction/postgresql-dataprovider": "6.2.0-edge.4",
+    "@memberjunction/queue": "6.2.0-edge.4",
+    "@memberjunction/record-cloning": "6.2.0-edge.4",
+    "@memberjunction/record-comparison": "6.2.0-edge.4",
+    "@memberjunction/redis-provider": "6.2.0-edge.4",
+    "@memberjunction/remote-browser-base": "6.2.0-edge.4",
+    "@memberjunction/remote-browser-cdp": "6.2.0-edge.4",
+    "@memberjunction/remote-browser-selfhost": "6.2.0-edge.4",
+    "@memberjunction/remote-browser-server": "6.2.0-edge.4",
+    "@memberjunction/scheduling-actions": "6.2.0-edge.4",
+    "@memberjunction/scheduling-base-types": "6.2.0-edge.4",
+    "@memberjunction/scheduling-engine": "6.2.0-edge.4",
+    "@memberjunction/scheduling-engine-base": "6.2.0-edge.4",
+    "@memberjunction/schema-engine": "6.2.0-edge.4",
+    "@memberjunction/search-engine": "6.2.0-edge.4",
+    "@memberjunction/server-extensions-core": "6.2.0-edge.4",
+    "@memberjunction/sql-dialect": "6.2.0-edge.4",
+    "@memberjunction/sql-parser": "6.2.0-edge.4",
+    "@memberjunction/sqlserver-dataprovider": "6.2.0-edge.4",
+    "@memberjunction/storage": "6.2.0-edge.4",
+    "@memberjunction/tag-engine": "6.2.0-edge.4",
+    "@memberjunction/tag-engine-base": "6.2.0-edge.4",
+    "@memberjunction/task-graph": "6.2.0-edge.4",
+    "@memberjunction/templates": "6.2.0-edge.4",
+    "@memberjunction/testing-engine": "6.2.0-edge.4",
+    "@memberjunction/testing-engine-base": "6.2.0-edge.4",
+    "@memberjunction/version-history": "6.2.0-edge.4",
+    "@memberjunction/work-queue-engine": "6.2.0-edge.4",
     "@octokit/auth-app": "^7.1.5",
     "@octokit/rest": "^21.1.1",
     "@types/compression": "^1.8.1",
@@ -149,7 +152,7 @@
     "zod": "^3.25.0"
   },
   "devDependencies": {
-    "@memberjunction/conversations-runtime": "6.2.0-edge.2",
+    "@memberjunction/conversations-runtime": "6.2.0-edge.4",
     "@types/express": "^5.0.6",
     "pkgroll": "2.23.0",
     "rimraf": "6.1.2",