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

package/dist/rest/UploadTokenManager.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @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 } from '@memberjunction/global';
+/**
+ * An ephemeral in-memory staged upload record.
+ */
+export interface StagedUploadEntry {
+    token: string;
+    buffer: Buffer;
+    fileName: string;
+    mimeType: string;
+    contentLength: number;
+    userId: string;
+    createdAt: number;
+    expiresAt: number;
+    timer: NodeJS.Timeout;
+}
+/**
+ * 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 declare class UploadTokenManager extends BaseSingleton<UploadTokenManager> {
+    private readonly _staged;
+    private _totalMemoryBytes;
+    defaultTtlSeconds: number;
+    maxFileSizeBytes: number;
+    maxUserMemoryBytes: number;
+    maxPoolMemoryBytes: number;
+    constructor();
+    static get Instance(): UploadTokenManager;
+    /**
+     * Calculates total active staged bytes currently held for a given user.
+     */
+    GetUserMemoryBytes(userId: string): number;
+    /**
+     * 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: {
+        buffer: Buffer;
+        fileName: string;
+        mimeType: string;
+        userId: string;
+        ttlSeconds?: number;
+    }): string;
+    /**
+     * 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: string, claimingUserId?: string): {
+        buffer: Buffer;
+        fileName: string;
+        mimeType: string;
+        contentLength: number;
+    } | null;
+    /**
+     * Evicts a token from RAM and reclaims memory.
+     */
+    Evict(token: string): boolean;
+    /** Total RAM in bytes currently consumed by all active staged uploads. */
+    get TotalMemoryBytes(): number;
+    /** Count of currently active staged uploads. */
+    get ActiveCount(): number;
+    /** Clears all active staged uploads. */
+    Clear(): void;
+}
+//# sourceMappingURL=UploadTokenManager.d.ts.map

package/dist/rest/UploadTokenManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadTokenManager.d.ts","sourceRoot":"","sources":["../../src/rest/UploadTokenManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAc,MAAM,wBAAwB,CAAC;AAInE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,SAAQ,aAAa,CAAC,kBAAkB,CAAC;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,iBAAiB,CAAK;IAEvB,iBAAiB,SAAO;IACxB,gBAAgB,SAAqB;IACrC,kBAAkB,SAAqB;IACvC,kBAAkB,SAAqB;;IAO9C,WAAkB,QAAQ,IAAI,kBAAkB,CAE/C;IAED;;OAEG;IACI,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAUjD;;;;OAIG;IACI,KAAK,CAAC,MAAM,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,MAAM;IAsDV;;;;;;OAMG;IACI,OAAO,CACZ,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA0BvF;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAYpC,0EAA0E;IAC1E,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,gDAAgD;IAChD,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,wCAAwC;IACjC,KAAK,IAAI,IAAI;CAOrB"}

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/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/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;AAE1F,OAAO,GAAG,MAAM,OAAO,CAAC;AAUxB;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,GAAG,CAAC,cAAc,EACxB,WAAW,EAAE,QAAQ,EACrB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAgC9B"}
+{"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

@@ -4,6 +4,7 @@ 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';
@@ -18,11 +19,30 @@ 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), 

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;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,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,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;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"}
+{"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/TaskGraphAgentRunner.d.ts

@@ -1,6 +1,13 @@
 import type { TaskAgentRunner, TaskAgentRunParams, TaskAgentRunResult } from '@memberjunction/task-graph';
 export declare class TaskGraphAgentRunner implements TaskAgentRunner {
     RunAgentForTask(params: TaskAgentRunParams): Promise<TaskAgentRunResult>;
+    /**
+     * Adapts the agent framework's progress callback onto the dispatcher's plain sink.
+     *
+     * Undefined when nobody is listening, so the agent run pays nothing for observability it is not
+     * providing. Never throws — a progress announcement must not be able to fail the step.
+     */
+    private bridgeProgress;
     /**
      * The run that submitted this graph, as the entity `RunAgent` wants for `parentRun`.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"TaskGraphAgentRunner.d.ts","sourceRoot":"","sources":["../../src/services/TaskGraphAgentRunner.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAE1G,qBAAa,oBAAqB,YAAW,eAAe;IAC3C,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+BrF;;;;;;;;;;;OAWG;YACW,iBAAiB;IAkB/B;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAmBnB,8FAA8F;IAC9F,OAAO,CAAC,aAAa;CAKxB"}
+{"version":3,"file":"TaskGraphAgentRunner.d.ts","sourceRoot":"","sources":["../../src/services/TaskGraphAgentRunner.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAE1G,qBAAa,oBAAqB,YAAW,eAAe;IAC3C,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmCrF;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAYtB;;;;;;;;;;;OAWG;YACW,iBAAiB;IAkB/B;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAmBnB,8FAA8F;IAC9F,OAAO,CAAC,aAAa;CAKxB"}

package/dist/services/TaskGraphAgentRunner.js

@@ -30,6 +30,10 @@ export class TaskGraphAgentRunner {
                 // rather than starting the chain over. Without it MAX_REINVOKE_DEPTH never fires.
                 continuationDepth: params.ContinuationDepth ?? 0,
                 parentRun: await this.loadSubmittingRun(params),
+                // The bridge from the agent's own progress stream up to graph-level observers: the
+                // dispatcher turns these into rate-limited `NodeProgress` frames, which is how a
+                // running Agent step shows "what it is doing right now" on the workflow canvas.
+                onProgress: this.bridgeProgress(params),
             });
             const success = result?.success === true;
             return {
@@ -45,6 +49,25 @@ export class TaskGraphAgentRunner {
             return { Success: false, ErrorMessage: message };
         }
     }
+    /**
+     * Adapts the agent framework's progress callback onto the dispatcher's plain sink.
+     *
+     * Undefined when nobody is listening, so the agent run pays nothing for observability it is not
+     * providing. Never throws — a progress announcement must not be able to fail the step.
+     */
+    bridgeProgress(params) {
+        const sink = params.OnProgress;
+        if (!sink)
+            return undefined;
+        return (progress) => {
+            try {
+                sink(progress.message, progress.percentage);
+            }
+            catch {
+                // The dispatcher's sink already guards itself; this is belt over braces.
+            }
+        };
+    }
     /**
      * The run that submitted this graph, as the entity `RunAgent` wants for `parentRun`.
      *

package/dist/services/TaskGraphAgentRunner.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"TaskGraphContinuationDeliverer.d.ts","sourceRoot":"","sources":["../../src/services/TaskGraphContinuationDeliverer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA+C,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKlG,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAKrH;;;;;;;;;;;GAWG;AACH,qBAAa,8BAA+B,YAAW,yBAAyB;IAOxE,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAPhC;;;;OAIG;gBAEkB,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,QAAQ;IAG1C;;;;;;OAMG;IACU,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCvE;;;;;;;;;OASG;IACU,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCpE,4CAA4C;YAC9B,qBAAqB;IAKnC;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,UAAU;CAQrB"}
+{"version":3,"file":"TaskGraphContinuationDeliverer.d.ts","sourceRoot":"","sources":["../../src/services/TaskGraphContinuationDeliverer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA+C,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKlG,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAKrH;;;;;;;;;;;GAWG;AACH,qBAAa,8BAA+B,YAAW,yBAAyB;IAOxE,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAPhC;;;;OAIG;gBAEkB,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,QAAQ;IAG1C;;;;;;OAMG;IACU,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCvE;;;;;;;;;OASG;IACU,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDpE,4CAA4C;YAC9B,qBAAqB;IAKnC;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,UAAU;CAQrB"}

package/dist/services/TaskGraphContinuationDeliverer.js

@@ -120,7 +120,18 @@ export class TaskGraphContinuationDeliverer {
             });
         }
         catch (e) {
-            LogError(`[TaskGraphContinuationDeliverer] Reinvoking for "${params.WorkflowName}" threw`, undefined, e);
+            // FALL BACK, don't just log (C3). Both load-failure paths above already post instead of
+            // reinvoking, on the principle that a completed workflow's outcome must reach the user
+            // somehow — but a throw out of `RunAgent` skipped that and lost the outcome entirely.
+            // The marker has been claimed by the time this runs, so nothing will look at the graph
+            // again: the work finished, and the only record of it is a server log line.
+            LogError(`[TaskGraphContinuationDeliverer] Reinvoking for "${params.WorkflowName}" threw — posting instead`, undefined, e);
+            try {
+                await this.PostMessage(params);
+            }
+            catch (fallbackError) {
+                LogError(`[TaskGraphContinuationDeliverer] The fallback post for "${params.WorkflowName}" also failed`, undefined, fallbackError);
+            }
         }
     }
     /** The conversation a detail belongs to. */