@memberjunction/server 6.1.0-edge.1 → 6.1.0-edge.3

package/dist/rest/UploadTokenManager.js

@@ -0,0 +1,156 @@
+/**
+ * @fileoverview Ephemeral in-memory staged upload token manager.
+ *
+ * Provides a secure, single-use, time-to-live (TTL) bounded staging area for raw
+ * binary upload buffers received via REST streaming before being committed through
+ * the GraphQL `UploadStorageFile` pipeline.
+ *
+ * Security properties:
+ * - Single-use nonce: Token and buffer are atomically destroyed on first consumption.
+ * - User binding: Tokens are bound to the authenticated User ID that uploaded them.
+ * - Auto-eviction: Abandoned tokens are automatically evicted from RAM after the TTL.
+ * - Memory caps: Enforces per-file max size (default 100MB) and total pool capacity (default 500MB).
+ *
+ * @module @memberjunction/server/rest/UploadTokenManager
+ */
+import { BaseSingleton, UUIDsEqual } from '@memberjunction/global';
+import { LogError } from '@memberjunction/core';
+import { randomBytes } from 'node:crypto';
+/**
+ * Ephemeral In-Memory Staged Upload Token Manager.
+ *
+ * Architecture & Deployment Topology Note:
+ * This implementation maintains staged buffers in-process RAM with a 5-minute sliding TTL.
+ * In a clustered/multi-replica deployment behind a load balancer, sticky sessions (or routing
+ * the subsequent GraphQL `UploadStorageFile` commit to the same node) are recommended.
+ * For shared-memory multi-node clustering, an external ephemeral store (such as Redis)
+ * can be plugged in behind this interface.
+ */
+export class UploadTokenManager extends BaseSingleton {
+    // Public constructor required by BaseSingleton
+    constructor() {
+        super();
+        this._staged = new Map();
+        this._totalMemoryBytes = 0;
+        this.defaultTtlSeconds = 300; // 5 minutes
+        this.maxFileSizeBytes = 100 * 1024 * 1024; // 100 MB
+        this.maxUserMemoryBytes = 150 * 1024 * 1024; // 150 MB per user
+        this.maxPoolMemoryBytes = 500 * 1024 * 1024; // 500 MB
+    }
+    static get Instance() {
+        return UploadTokenManager.getInstance();
+    }
+    /**
+     * Calculates total active staged bytes currently held for a given user.
+     */
+    GetUserMemoryBytes(userId) {
+        let total = 0;
+        for (const entry of this._staged.values()) {
+            if (UUIDsEqual(entry.userId, userId)) {
+                total += entry.contentLength;
+            }
+        }
+        return total;
+    }
+    /**
+     * Stages a raw binary buffer in RAM, returning a single-use cryptographic token.
+     *
+     * @throws Error if buffer exceeds single file limit, per-user quota, or global pool memory capacity.
+     */
+    Stage(params) {
+        const size = params.buffer.length;
+        if (size > this.maxFileSizeBytes) {
+            throw new Error(`Staged upload exceeds maximum allowed file size of ${Math.round(this.maxFileSizeBytes / (1024 * 1024))}MB (received ${Math.round(size / (1024 * 1024))}MB).`);
+        }
+        const userCurrentBytes = this.GetUserMemoryBytes(params.userId);
+        if (userCurrentBytes + size > this.maxUserMemoryBytes) {
+            throw new Error(`Per-user upload memory quota reached (${Math.round(userCurrentBytes / (1024 * 1024))}MB / ${Math.round(this.maxUserMemoryBytes / (1024 * 1024))}MB used). Please wait for active uploads to finalize.`);
+        }
+        if (this._totalMemoryBytes + size > this.maxPoolMemoryBytes) {
+            throw new Error(`Staged upload memory capacity reached (${Math.round(this._totalMemoryBytes / (1024 * 1024))}MB / ${Math.round(this.maxPoolMemoryBytes / (1024 * 1024))}MB used). Please try again shortly.`);
+        }
+        const token = 'upt_' + randomBytes(32).toString('hex');
+        const ttl = params.ttlSeconds || this.defaultTtlSeconds;
+        const now = Date.now();
+        const expiresAt = now + ttl * 1000;
+        const timer = setTimeout(() => {
+            this.Evict(token);
+        }, ttl * 1000);
+        // Unref timer so it doesn't hold open process shutdown in tests or CLI
+        if (typeof timer.unref === 'function') {
+            timer.unref();
+        }
+        const entry = {
+            token,
+            buffer: params.buffer,
+            fileName: params.fileName,
+            mimeType: params.mimeType,
+            contentLength: size,
+            userId: params.userId,
+            createdAt: now,
+            expiresAt,
+            timer,
+        };
+        this._staged.set(token, entry);
+        this._totalMemoryBytes += size;
+        return token;
+    }
+    /**
+     * Atomically consumes and evicts a staged upload token.
+     *
+     * @param token The staged upload token.
+     * @param claimingUserId The user ID claiming this token. If provided, must match the user who uploaded it.
+     * @returns The staged buffer and metadata, or null if the token is invalid, expired, or claimed by the wrong user.
+     */
+    Consume(token, claimingUserId) {
+        if (!token || !this._staged.has(token)) {
+            return null;
+        }
+        const entry = this._staged.get(token);
+        // Security check: verify user ownership using UUIDsEqual for robust ID normalization
+        if (claimingUserId && entry.userId && !UUIDsEqual(entry.userId, claimingUserId)) {
+            LogError(`[UploadTokenManager] Security violation: User '${claimingUserId}' attempted to claim upload token owned by User '${entry.userId}'.`);
+            // Evict immediately to prevent further probing
+            this.Evict(token);
+            return null;
+        }
+        // Atomic consumption & memory reclamation
+        this.Evict(token);
+        return {
+            buffer: entry.buffer,
+            fileName: entry.fileName,
+            mimeType: entry.mimeType,
+            contentLength: entry.contentLength,
+        };
+    }
+    /**
+     * Evicts a token from RAM and reclaims memory.
+     */
+    Evict(token) {
+        const entry = this._staged.get(token);
+        if (!entry) {
+            return false;
+        }
+        clearTimeout(entry.timer);
+        this._staged.delete(token);
+        this._totalMemoryBytes = Math.max(0, this._totalMemoryBytes - entry.contentLength);
+        return true;
+    }
+    /** Total RAM in bytes currently consumed by all active staged uploads. */
+    get TotalMemoryBytes() {
+        return this._totalMemoryBytes;
+    }
+    /** Count of currently active staged uploads. */
+    get ActiveCount() {
+        return this._staged.size;
+    }
+    /** Clears all active staged uploads. */
+    Clear() {
+        for (const [, entry] of this._staged) {
+            clearTimeout(entry.timer);
+        }
+        this._staged.clear();
+        this._totalMemoryBytes = 0;
+    }
+}
+//# sourceMappingURL=UploadTokenManager.js.map

package/dist/rest/UploadTokenManager.js.map

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

package/dist/services/DurableEntityActionTaskSubmitter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview MJServer's implementation of the `DurableEntityActionSubmitter` seam.
+ *
+ * Turns one After* entity-action dispatch into a single-node durable task graph, which is D14's
+ * whole answer to "run this durably": not a new queue, the substrate that already has a claim
+ * protocol, restart recovery and orphan reclaim.
+ *
+ * Registered at boot beside the dispatcher, because the two are one capability — a submitter with
+ * no dispatcher writes rows nobody picks up, which is worse than staying inline.
+ *
+ * @module @memberjunction/server
+ */
+import type { DurableEntityActionRequest, DurableEntityActionSubmission, DurableEntityActionSubmitter } from '@memberjunction/actions-base';
+import { type ProviderFactory } from '@memberjunction/task-graph';
+export declare class DurableEntityActionTaskSubmitter implements DurableEntityActionSubmitter {
+    private readonly providerFactory;
+    private readonly environmentID;
+    /**
+     * @param environmentID which environment the tasks belong to. Defaults to the platform default
+     *   because a save has no environment of its own to inherit — the record's entity is global, and
+     *   inventing a per-save environment would put a durable dispatch somewhere nobody looks.
+     */
+    constructor(providerFactory: ProviderFactory, environmentID?: string);
+    Submit(request: DurableEntityActionRequest): Promise<DurableEntityActionSubmission>;
+}
+//# sourceMappingURL=DurableEntityActionTaskSubmitter.d.ts.map

package/dist/services/DurableEntityActionTaskSubmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DurableEntityActionTaskSubmitter.d.ts","sourceRoot":"","sources":["../../src/services/DurableEntityActionTaskSubmitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACR,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC/B,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEpF,qBAAa,gCAAiC,YAAW,4BAA4B;IAO7E,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAPlC;;;;OAIG;gBAEkB,eAAe,EAAE,eAAe,EAChC,aAAa,GAAE,MAAyD;IAGhF,MAAM,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,6BAA6B,CAAC;CA4CnG"}

package/dist/services/DurableEntityActionTaskSubmitter.js

@@ -0,0 +1,55 @@
+import { LogError } from '@memberjunction/core';
+import { TaskNode } from '@memberjunction/ai-core-plus';
+import { MJEnvironmentEntityExtended } from '@memberjunction/core-entities';
+import { TaskGraphService } from '@memberjunction/task-graph';
+export class DurableEntityActionTaskSubmitter {
+    /**
+     * @param environmentID which environment the tasks belong to. Defaults to the platform default
+     *   because a save has no environment of its own to inherit — the record's entity is global, and
+     *   inventing a per-save environment would put a durable dispatch somewhere nobody looks.
+     */
+    constructor(providerFactory, environmentID = MJEnvironmentEntityExtended.DefaultEnvironmentID) {
+        this.providerFactory = providerFactory;
+        this.environmentID = environmentID;
+    }
+    async Submit(request) {
+        try {
+            const spec = {
+                workflowName: `${request.ActionName} — ${request.EntityName}`,
+                reasoning: `Durable dispatch of entity action binding ${request.EntityActionID} on ` +
+                    `${request.EntityName} (${request.RecordID}), fired by ${request.InvocationType}.`,
+                tasks: [
+                    TaskNode.Action({
+                        tempId: 'action',
+                        name: request.ActionName,
+                        description: `Run ${request.ActionName} for ${request.EntityName} ${request.RecordID}.`,
+                        dependsOn: [],
+                        inputPayload: request.RedactedParams,
+                    }, { actionName: request.ActionName }),
+                ],
+                // Nothing to say to anyone: this graph exists because a record was saved, not
+                // because a person asked a question. Defaulting to 'message' would post an
+                // orphaned result into whichever conversation happened to be nearby.
+                continuation: 'none',
+                // The point of the exercise. A one-node graph constant-folds to in-run execution by
+                // default (D9), which is exactly the fire-and-forget behaviour being escaped.
+                durable: true,
+            };
+            const provider = await this.providerFactory.CreateProvider();
+            const result = await new TaskGraphService().Submit(spec, {
+                EnvironmentID: this.environmentID,
+                ContextUser: request.ContextUser,
+                Provider: provider,
+            });
+            return result.Success
+                ? { Success: true, ParentTaskID: result.ParentTaskID }
+                : { Success: false, ErrorMessage: result.ErrorMessage };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            LogError(`[DurableEntityActionTaskSubmitter] Submission failed for binding ${request.EntityActionID}: ${message}`);
+            return { Success: false, ErrorMessage: message };
+        }
+    }
+}
+//# sourceMappingURL=DurableEntityActionTaskSubmitter.js.map

package/dist/services/DurableEntityActionTaskSubmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DurableEntityActionTaskSubmitter.js","sourceRoot":"","sources":["../../src/services/DurableEntityActionTaskSubmitter.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAsB,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAwB,MAAM,4BAA4B,CAAC;AAEpF,MAAM,OAAO,gCAAgC;IACzC;;;;OAIG;IACH,YACqB,eAAgC,EAChC,gBAAwB,2BAA2B,CAAC,oBAAoB;QADxE,oBAAe,GAAf,eAAe,CAAiB;QAChC,kBAAa,GAAb,aAAa,CAA2D;IAC1F,CAAC;IAEG,KAAK,CAAC,MAAM,CAAC,OAAmC;QACnD,IAAI,CAAC;YACD,MAAM,IAAI,GAAkB;gBACxB,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,MAAM,OAAO,CAAC,UAAU,EAAE;gBAC7D,SAAS,EACL,6CAA6C,OAAO,CAAC,cAAc,MAAM;oBACzE,GAAG,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,QAAQ,eAAe,OAAO,CAAC,cAAc,GAAG;gBACtF,KAAK,EAAE;oBACH,QAAQ,CAAC,MAAM,CACX;wBACI,MAAM,EAAE,QAAQ;wBAChB,IAAI,EAAE,OAAO,CAAC,UAAU;wBACxB,WAAW,EAAE,OAAO,OAAO,CAAC,UAAU,QAAQ,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ,GAAG;wBACvF,SAAS,EAAE,EAAE;wBACb,YAAY,EAAE,OAAO,CAAC,cAAc;qBACvC,EACD,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CACrC;iBACJ;gBACD,8EAA8E;gBAC9E,2EAA2E;gBAC3E,qEAAqE;gBACrE,YAAY,EAAE,MAAM;gBACpB,oFAAoF;gBACpF,8EAA8E;gBAC9E,OAAO,EAAE,IAAI;aAChB,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC;YAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;gBACrD,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,QAAQ;aACrB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC,OAAO;gBACjB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE;gBACtD,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC3D,QAAQ,CAAC,oEAAoE,OAAO,CAAC,cAAc,KAAK,OAAO,EAAE,CAAC,CAAC;YACnH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;QACrD,CAAC;IACL,CAAC;CACJ"}

package/dist/services/IntegrationSyncWorkerService.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Worker-mode poll loop for durable integration sync runs (PR 1 item 8).
+ * @module MJServer/services
+ */
+import { IntegrationSyncWorkerConfig } from '../config.js';
+/**
+ * Polls `CompanyIntegrationRun` for `Status='Queued'` rows, claims each one atomically,
+ * executes it, and releases — the enqueue/execute split that lets a sync outlive the
+ * request that asked for it.
+ *
+ * Multiple workers (in this process or others) may poll the same queue: the claim sproc
+ * admits exactly one, and every loser simply moves on to the next candidate. Nothing here
+ * assumes it is the only worker.
+ */
+export declare class IntegrationSyncWorkerService {
+    private config;
+    private systemUser;
+    private timer;
+    private isRunning;
+    private polling;
+    /** Run IDs currently executing in THIS process — bounds concurrency and prevents self-collision. */
+    private inFlight;
+    constructor(config: IntegrationSyncWorkerConfig);
+    get IsEnabled(): boolean;
+    get IsRunning(): boolean;
+    /** Number of queued runs this worker is currently executing. */
+    get InFlightCount(): number;
+    /** Resolve the system user the worker executes syncs as. */
+    Initialize(): Promise<void>;
+    /** Begin polling the queue. */
+    Start(): void;
+    /**
+     * Stop polling. In-flight runs are left to finish on their own — their leases are
+     * renewed by the engine's heartbeat, so killing them here would only strand rows.
+     */
+    Stop(): void;
+    /**
+     * One poll pass: fetch claimable candidates up to the free concurrency slots and start
+     * each. Overlapping passes are suppressed so a slow query can't stack up timers.
+     */
+    private pollOnce;
+    /**
+     * Execute one queued run in the background. Losing the claim race is normal — the run
+     * is simply someone else's — so it is logged as information, never as an error.
+     */
+    private startRun;
+}
+//# sourceMappingURL=IntegrationSyncWorkerService.d.ts.map

package/dist/services/IntegrationSyncWorkerService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntegrationSyncWorkerService.d.ts","sourceRoot":"","sources":["../../src/services/IntegrationSyncWorkerService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D;;;;;;;;GAQG;AACH,qBAAa,4BAA4B;IACrC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,oGAAoG;IACpG,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,MAAM,EAAE,2BAA2B;IAI/C,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,gEAAgE;IAChE,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,4DAA4D;IAC/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWxC,+BAA+B;IACxB,KAAK,IAAI,IAAI;IAoBpB;;;OAGG;IACI,IAAI,IAAI,IAAI;IAUnB;;;OAGG;YACW,QAAQ;IAoBtB;;;OAGG;IACH,OAAO,CAAC,QAAQ;CAoBnB"}

package/dist/services/IntegrationSyncWorkerService.js

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Worker-mode poll loop for durable integration sync runs (PR 1 item 8).
+ * @module MJServer/services
+ */
+import { LogError, LogStatus } from '@memberjunction/core';
+import { UserCache } from '@memberjunction/generic-database-provider';
+import { IntegrationEngine } from '@memberjunction/integration-engine';
+/**
+ * Polls `CompanyIntegrationRun` for `Status='Queued'` rows, claims each one atomically,
+ * executes it, and releases — the enqueue/execute split that lets a sync outlive the
+ * request that asked for it.
+ *
+ * Multiple workers (in this process or others) may poll the same queue: the claim sproc
+ * admits exactly one, and every loser simply moves on to the next candidate. Nothing here
+ * assumes it is the only worker.
+ */
+export class IntegrationSyncWorkerService {
+    constructor(config) {
+        this.systemUser = null;
+        this.timer = null;
+        this.isRunning = false;
+        this.polling = false;
+        /** Run IDs currently executing in THIS process — bounds concurrency and prevents self-collision. */
+        this.inFlight = new Set();
+        this.config = config;
+    }
+    get IsEnabled() {
+        return this.config.enabled;
+    }
+    get IsRunning() {
+        return this.isRunning;
+    }
+    /** Number of queued runs this worker is currently executing. */
+    get InFlightCount() {
+        return this.inFlight.size;
+    }
+    /** Resolve the system user the worker executes syncs as. */
+    async Initialize() {
+        if (!this.config.enabled)
+            return;
+        const email = this.config.systemUserEmail;
+        this.systemUser = UserCache.Users.find(u => u.Email?.toLowerCase() === email.toLowerCase()) ?? null;
+        if (!this.systemUser) {
+            throw new Error(`[IntegrationSyncWorker] System user not found with email: ${email}`);
+        }
+        await IntegrationEngine.Instance.Config(false, this.systemUser);
+    }
+    /** Begin polling the queue. */
+    Start() {
+        if (!this.config.enabled || this.isRunning)
+            return;
+        if (!this.systemUser) {
+            throw new Error('[IntegrationSyncWorker] Not initialized — call Initialize() first');
+        }
+        this.isRunning = true;
+        this.timer = setInterval(() => void this.pollOnce(), this.config.pollingIntervalMs);
+        // Standard level, NOT verboseOnly: this states a deployment-shaping fact — that this process
+        // executes queued syncs — and it's one line per process lifetime. Stop() already logs at
+        // standard level, so hiding Start() produced logs showing a worker stopping that never
+        // started, and no way to confirm from logs that a deployment is in worker mode at all.
+        LogStatus(`🔄 Integration Sync Worker: polling every ${Math.round(this.config.pollingIntervalMs / 1000)}s, ` +
+            `up to ${this.config.maxConcurrentRuns} concurrent run(s)`);
+        // Don't wait a full interval to drain a queue that already has work.
+        void this.pollOnce();
+    }
+    /**
+     * Stop polling. In-flight runs are left to finish on their own — their leases are
+     * renewed by the engine's heartbeat, so killing them here would only strand rows.
+     */
+    Stop() {
+        if (!this.isRunning)
+            return;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.isRunning = false;
+        LogStatus(`[IntegrationSyncWorker] Stopped polling (${this.inFlight.size} run(s) still in flight)`);
+    }
+    /**
+     * One poll pass: fetch claimable candidates up to the free concurrency slots and start
+     * each. Overlapping passes are suppressed so a slow query can't stack up timers.
+     */
+    async pollOnce() {
+        if (this.polling || !this.isRunning || !this.systemUser)
+            return;
+        const slots = this.config.maxConcurrentRuns - this.inFlight.size;
+        if (slots <= 0)
+            return;
+        this.polling = true;
+        try {
+            const candidates = await IntegrationEngine.PollQueuedRuns(this.systemUser, slots);
+            for (const candidate of candidates) {
+                if (this.inFlight.has(candidate.ID))
+                    continue;
+                this.startRun(candidate.ID);
+            }
+        }
+        catch (err) {
+            LogError(`[IntegrationSyncWorker] Poll failed`, undefined, err);
+        }
+        finally {
+            this.polling = false;
+        }
+    }
+    /**
+     * Execute one queued run in the background. Losing the claim race is normal — the run
+     * is simply someone else's — so it is logged as information, never as an error.
+     */
+    startRun(runID) {
+        if (!this.systemUser)
+            return;
+        this.inFlight.add(runID);
+        void IntegrationEngine.Instance
+            .ExecuteQueuedRun(runID, this.systemUser)
+            .then(result => {
+            if (result.Success) {
+                LogStatus(`[IntegrationSyncWorker] Run ${runID} completed: ${result.RecordsProcessed} record(s) processed`);
+            }
+            else {
+                LogStatus(`[IntegrationSyncWorker] Run ${runID} did not complete: ${result.ErrorMessage ?? 'unknown reason'}`);
+            }
+        })
+            .catch(err => {
+            LogError(`[IntegrationSyncWorker] Run ${runID} threw`, undefined, err);
+        })
+            .finally(() => {
+            this.inFlight.delete(runID);
+        });
+    }
+}
+//# sourceMappingURL=IntegrationSyncWorkerService.js.map

package/dist/services/IntegrationSyncWorkerService.js.map

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

package/dist/services/ScheduledJobsService.js

@@ -3,7 +3,7 @@
  * @module MJServer/services
  */
 import { LogError, LogStatus, LogStatusEx } from '@memberjunction/core';
-import { UserCache } from '@memberjunction/sqlserver-dataprovider';
+import { UserCache } from '@memberjunction/generic-database-provider';
 import { SchedulingEngine } from '@memberjunction/scheduling-engine';
 /**
  * Service for managing scheduled jobs lifecycle

package/dist/services/ScheduledJobsService.js.map

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

package/dist/services/StartTaskGraphDispatcher.d.ts

@@ -19,15 +19,5 @@
 import { UserInfo } from '@memberjunction/core';
 import { TaskGraphDispatcher } from '@memberjunction/task-graph';
 import sql from 'mssql';
-/**
- * Starts one dispatcher for this process and returns it.
- *
- * The instance ID must be stable for the process lifetime and distinct per instance — it is what
- * lets reconciliation tell "my own orphaned work, reclaim it" from "another live instance's work,
- * leave it alone". `pid` plus hostname satisfies both: stable while the process lives, and never
- * reused by a peer.
- *
- * The dispatcher self-registers with `ShutdownRegistry`, so the caller does not wire teardown.
- */
 export declare function StartTaskGraphDispatcher(pool: sql.ConnectionPool, contextUser: UserInfo, instanceID?: string): Promise<TaskGraphDispatcher>;
 //# sourceMappingURL=StartTaskGraphDispatcher.d.ts.map

package/dist/services/StartTaskGraphDispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartTaskGraphDispatcher.d.ts","sourceRoot":"","sources":["../../src/services/StartTaskGraphDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAA2B,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,GAAG,MAAM,OAAO,CAAC;AAOxB;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,GAAG,CAAC,cAAc,EACxB,WAAW,EAAE,QAAQ,EACrB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAmB9B"}
+{"version":3,"file":"StartTaskGraphDispatcher.d.ts","sourceRoot":"","sources":["../../src/services/StartTaskGraphDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAA2B,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE1F,OAAO,GAAG,MAAM,OAAO,CAAC;AAkCxB,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,GAAG,CAAC,cAAc,EACxB,WAAW,EAAE,QAAQ,EACrB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAsC9B"}

package/dist/services/StartTaskGraphDispatcher.js

@@ -1,6 +1,11 @@
 import { LoadTaskGraphOperations, TaskGraphDispatcher } from '@memberjunction/task-graph';
+import { TaskGraphPromptRunner } from './TaskGraphPromptRunner.js';
+import { DurableEntityActionRegistry } from '@memberjunction/actions-base';
 import { CreateTaskGraphProviderFactory } from './TaskGraphProviderFactory.js';
+import { TaskGraphActionRunner } from './TaskGraphActionRunner.js';
 import { TaskGraphAgentRunner } from './TaskGraphAgentRunner.js';
+import { randomBytes } from 'node:crypto';
+import { DurableEntityActionTaskSubmitter } from './DurableEntityActionTaskSubmitter.js';
 import { TaskGraphContinuationDeliverer } from './TaskGraphContinuationDeliverer.js';
 import { PubSubManager } from '../generic/PubSubManager.js';
 import { TaskGraphFrameBroadcaster } from '../resolvers/TaskGraphFrameResolver.js';
@@ -14,18 +19,48 @@ import { TaskGraphFrameBroadcaster } from '../resolvers/TaskGraphFrameResolver.j
  *
  * The dispatcher self-registers with `ShutdownRegistry`, so the caller does not wire teardown.
  */
+/**
+ * A per-process identity for the claim protocol.
+ *
+ * Host and pid are kept because they are what a human reads in a log; the random suffix is what
+ * makes the value actually unique. Generated once per call, so a restart is a new instance — which
+ * is correct: the previous process's claims should expire rather than be inherited.
+ */
+function defaultInstanceID() {
+    const host = process.env.HOSTNAME ?? 'mjapi';
+    const entropy = randomBytes(4).toString('hex');
+    return `${host}-${process.pid}-${entropy}`;
+}
 export async function StartTaskGraphDispatcher(pool, contextUser, instanceID) {
     LoadTaskGraphOperations();
     const providerFactory = CreateTaskGraphProviderFactory(pool);
     const pubSub = PubSubManager.Instance.PubSubEngine;
-    const dispatcher = new TaskGraphDispatcher(providerFactory, new TaskGraphAgentRunner(), contextUser, { InstanceID: instanceID ?? `${process.env.HOSTNAME ?? 'mjapi'}-${process.pid}` }, 
+    const dispatcher = new TaskGraphDispatcher(providerFactory, new TaskGraphAgentRunner(), contextUser, 
+    // A RANDOM SUFFIX, because host+pid is not unique in the deployments this runs in (C2).
+    // `HOSTNAME` is not exported to child processes under systemd or pm2, and a containerised
+    // process is routinely pid 1 — so two hosts default to the same `mjapi-1`. A shared instance
+    // id defeats every `ClaimedBy=@me` guard at once: A's heartbeat renews B's lease, and A's
+    // stale terminal write lands over B's live execution. An explicit `instanceID` still wins,
+    // for hosts that have a real identity to supply.
+    { InstanceID: instanceID ?? defaultInstanceID() }, 
     // Without this the dispatcher had nowhere to deliver: a finished graph logged its outcome,
     // marked itself delivered, and said nothing to the conversation that asked for it.
     new TaskGraphContinuationDeliverer(providerFactory, contextUser), 
     // Live signal. Supplied only when a PubSub engine exists — in a worker or a test there is
     // nobody to publish to, and the dispatcher runs identically without one.
-    pubSub ? new TaskGraphFrameBroadcaster(pubSub) : undefined);
+    pubSub ? new TaskGraphFrameBroadcaster(pubSub) : undefined, 
+    // Action nodes — the third execution shape, beside agents and people. Durable After* entity
+    // actions land as these.
+    new TaskGraphActionRunner(), 
+    // Prompt nodes. Without this a Flow agent with a Prompt step submits and then
+    // stalls on a task nothing can execute — which is why the shipped User Onboarding
+    // Flow Agent could not run at all before this seam existed.
+    new TaskGraphPromptRunner());
     await dispatcher.Start();
+    // Registered only AFTER the dispatcher is running, and only here. A submitter without a
+    // dispatcher writes Task rows nobody picks up — strictly worse than staying inline, because the
+    // work is now both undone and invisible in the place it used to be logged.
+    DurableEntityActionRegistry.Instance.Register(new DurableEntityActionTaskSubmitter(providerFactory));
     return dispatcher;
 }
 //# sourceMappingURL=StartTaskGraphDispatcher.js.map

package/dist/services/StartTaskGraphDispatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"StartTaskGraphDispatcher.js","sourceRoot":"","sources":["../../src/services/StartTaskGraphDispatcher.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,IAAwB,EACxB,WAAqB,EACrB,UAAmB;IAEnB,uBAAuB,EAAE,CAAC;IAE1B,MAAM,eAAe,GAAG,8BAA8B,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,mBAAmB,CACtC,eAAe,EACf,IAAI,oBAAoB,EAAE,EAC1B,WAAW,EACX,EAAE,UAAU,EAAE,UAAU,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE;IACjF,2FAA2F;IAC3F,mFAAmF;IACnF,IAAI,8BAA8B,CAAC,eAAe,EAAE,WAAW,CAAC;IAChE,0FAA0F;IAC1F,yEAAyE;IACzE,MAAM,CAAC,CAAC,CAAC,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAC7D,CAAC;IACF,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;IACzB,OAAO,UAAU,CAAC;AACtB,CAAC"}
+{"version":3,"file":"StartTaskGraphDispatcher.js","sourceRoot":"","sources":["../../src/services/StartTaskGraphDispatcher.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAEnF;;;;;;;;;GASG;AACH;;;;;;GAMG;AACH,SAAS,iBAAiB;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC;IAC7C,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,IAAwB,EACxB,WAAqB,EACrB,UAAmB;IAEnB,uBAAuB,EAAE,CAAC;IAE1B,MAAM,eAAe,GAAG,8BAA8B,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,mBAAmB,CACtC,eAAe,EACf,IAAI,oBAAoB,EAAE,EAC1B,WAAW;IACX,wFAAwF;IACxF,0FAA0F;IAC1F,6FAA6F;IAC7F,0FAA0F;IAC1F,2FAA2F;IAC3F,iDAAiD;IACjD,EAAE,UAAU,EAAE,UAAU,IAAI,iBAAiB,EAAE,EAAE;IACjD,2FAA2F;IAC3F,mFAAmF;IACnF,IAAI,8BAA8B,CAAC,eAAe,EAAE,WAAW,CAAC;IAChE,0FAA0F;IAC1F,yEAAyE;IACzE,MAAM,CAAC,CAAC,CAAC,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;IAC1D,4FAA4F;IAC5F,yBAAyB;IACzB,IAAI,qBAAqB,EAAE;IAC3B,8EAA8E;IAC9E,kFAAkF;IAClF,4DAA4D;IAC5D,IAAI,qBAAqB,EAAE,CAC9B,CAAC;IACF,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;IAEzB,wFAAwF;IACxF,gGAAgG;IAChG,2EAA2E;IAC3E,2BAA2B,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,gCAAgC,CAAC,eAAe,CAAC,CAAC,CAAC;IAErG,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/dist/services/TaskGraphActionRunner.d.ts

@@ -0,0 +1,34 @@
+import type { TaskActionRunner, TaskActionRunParams, TaskActionRunResult } from '@memberjunction/task-graph';
+export declare class TaskGraphActionRunner implements TaskActionRunner {
+    RunActionForTask(params: TaskActionRunParams): Promise<TaskActionRunResult>;
+    /**
+     * Projects the action's parameters onto the flat result a workflow step is expected to produce.
+     *
+     * **Why not return `result.Params` as-is.** That is an `ActionParam[]`, and every consumer of a
+     * step's output addresses fields BY NAME: an output mapping says `{"CurrentPrice": "stockPrice"}`,
+     * and a branch condition then reads `payload.stockPrice`. Handed an array, the mapping finds no
+     * `CurrentPrice`, writes nothing, and the condition evaluates against `undefined` — which is
+     * falsy rather than erroneous, so the workflow takes the other branch and reports success. That
+     * is exactly what the Demo workflow did: step 1 completed with an output payload of `{}` and
+     * every downstream branch was skipped, with nothing anywhere reporting a problem.
+     *
+     * Only `Output` and `Both` params are included. Echoing the inputs back would let a step's own
+     * parameters masquerade as its results, so an output mapping could "succeed" by reading the
+     * value the step was given rather than the one it produced.
+     */
+    private buildOutput;
+    /**
+     * Rebuilds the action's parameters from the task's stored payload.
+     *
+     * **The values here have been through redaction**, because `Task.InputPayload` is persistent,
+     * user-visible storage and nothing writes a raw `ActionParam[]` there. A parameter the binding
+     * marked as not-logged therefore arrives absent rather than secret — the action sees a missing
+     * value, which is the honest consequence of choosing not to persist it, and the reason durable
+     * dispatch is opt-in per binding rather than the default.
+     *
+     * Dependency outputs are merged underneath the task's own input so a node's explicit parameters
+     * always win over an upstream node that happened to emit the same key.
+     */
+    private buildParams;
+}
+//# sourceMappingURL=TaskGraphActionRunner.d.ts.map

package/dist/services/TaskGraphActionRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskGraphActionRunner.d.ts","sourceRoot":"","sources":["../../src/services/TaskGraphActionRunner.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE7G,qBAAa,qBAAsB,YAAW,gBAAgB;IAC7C,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmCxF;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAW;CAUtB"}