@memberjunction/server 5.40.2 → 5.42.0

package/dist/agentSessions/HostInstance.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Returns this process's stable host-instance identity (`hostname:pid:bootId`).
+ * Stamped into `AIAgentSession.HostInstanceID` at session create and read back by the
+ * janitor for own-host orphan recovery.
+ */
+export declare function GetHostInstanceID(): string;
+/**
+ * Returns the host-name prefix (`hostname:`) used to match *any* session previously hosted
+ * by this OS host, regardless of which boot created it. The janitor uses this to find rows
+ * that belong to this host but to a *different* (older) boot — i.e. crash/redeploy orphans.
+ */
+export declare function GetHostNamePrefix(): string;
+/**
+ * Returns the UUID generated once at process start. Exposed primarily for diagnostics and
+ * tests; the janitor compares against the full {@link GetHostInstanceID} rather than this
+ * value directly.
+ */
+export declare function GetBootID(): string;
+//# sourceMappingURL=HostInstance.d.ts.map

package/dist/agentSessions/HostInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostInstance.d.ts","sourceRoot":"","sources":["../../src/agentSessions/HostInstance.ts"],"names":[],"mappings":"AA2BA;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/agentSessions/HostInstance.js

@@ -0,0 +1,48 @@
+import { hostname } from 'os';
+import { randomUUID } from 'crypto';
+/**
+ * Stable, per-process identity for this server node, used to anchor
+ * {@link import('@memberjunction/core-entities').MJAIAgentSessionEntity} rows to the
+ * instance that currently owns their in-memory sockets.
+ *
+ * The shape is `${hostname}:${pid}:${bootId}` where:
+ * - `hostname` and `pid` locate the OS process,
+ * - `bootId` is a UUID generated **once** at module load, so two different boots of the
+ *   *same* host (a crash/redeploy that reuses pid, or a long-lived host that restarts the
+ *   process) produce **distinct** identities.
+ *
+ * This last property is what lets {@link import('./SessionJanitor.js').SessionJanitor} tell a
+ * live session owned by *this* boot apart from an orphan left by a *previous* boot of the
+ * same host: only the latter has a `HostInstanceID` that starts with `${hostname}:` but
+ * carries a different `bootId`.
+ */
+const BOOT_ID = randomUUID();
+/** Resolved host name captured once at load (cheap; avoids repeated syscalls). */
+const HOST_NAME = hostname();
+/** The full, immutable host-instance identity string for this process. */
+const HOST_INSTANCE_ID = `${HOST_NAME}:${process.pid}:${BOOT_ID}`;
+/**
+ * Returns this process's stable host-instance identity (`hostname:pid:bootId`).
+ * Stamped into `AIAgentSession.HostInstanceID` at session create and read back by the
+ * janitor for own-host orphan recovery.
+ */
+export function GetHostInstanceID() {
+    return HOST_INSTANCE_ID;
+}
+/**
+ * Returns the host-name prefix (`hostname:`) used to match *any* session previously hosted
+ * by this OS host, regardless of which boot created it. The janitor uses this to find rows
+ * that belong to this host but to a *different* (older) boot — i.e. crash/redeploy orphans.
+ */
+export function GetHostNamePrefix() {
+    return `${HOST_NAME}:`;
+}
+/**
+ * Returns the UUID generated once at process start. Exposed primarily for diagnostics and
+ * tests; the janitor compares against the full {@link GetHostInstanceID} rather than this
+ * value directly.
+ */
+export function GetBootID() {
+    return BOOT_ID;
+}
+//# sourceMappingURL=HostInstance.js.map

package/dist/agentSessions/HostInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostInstance.js","sourceRoot":"","sources":["../../src/agentSessions/HostInstance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;AAE7B,kFAAkF;AAClF,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC;AAE7B,0EAA0E;AAC1E,MAAM,gBAAgB,GAAG,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC7B,OAAO,gBAAgB,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC7B,OAAO,GAAG,SAAS,GAAG,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACrB,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/agentSessions/SessionJanitor.d.ts

@@ -0,0 +1,97 @@
+import { BaseSingleton, IShutdownable } from '@memberjunction/global';
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+/** Tuning knobs for the janitor. All durations in their named units. */
+export interface SessionJanitorConfig {
+    /** A non-`Closed` session whose `LastActiveAt` is older than this is force-closed by the global sweep. */
+    closeThresholdMinutes: number;
+    /** How often the periodic staleness sweep runs once {@link SessionJanitor.Start} is called. */
+    sweepIntervalMs: number;
+}
+/**
+ * `BaseSingleton` background reconciler that keeps the durable `AIAgentSession` state from drifting
+ * away from volatile process reality. A crash/redeploy vaporizes a host's in-memory sockets but
+ * leaves its session rows reading `Active`/`Idle` forever; the janitor force-closes those orphans.
+ *
+ * Two sweeps, both writing through {@link SessionManager.CloseSession} so Record Changes captures
+ * each transition and channel rows are disconnected consistently:
+ *
+ * 1. **Own-host recovery ({@link RunStartupRecovery})** — run once at boot. Closes any `Active`/`Idle`
+ *    session whose `HostInstanceID` belongs to a *previous* boot of *this* host (same hostname prefix,
+ *    different `bootId`). Primary defense against the "Active forever" leak after a restart.
+ * 2. **Global staleness sweep ({@link RunStalenessSweep})** — run periodically on every instance.
+ *    Closes any `Active`/`Idle` session whose `LastActiveAt` is older than `closeThresholdMinutes`,
+ *    regardless of host. Catches sessions whose owner died without a clean reboot (OOM, scaled-down pod).
+ *
+ * Both sweeps stamp `CloseReason = 'Janitor'`. A third, shutdown-time path —
+ * {@link RunShutdownDrain}, invoked from {@link Shutdown} during the graceful ShutdownRegistry
+ * drain — closes this exact host instance's own live sessions with `CloseReason = 'Shutdown'`.
+ *
+ * Both sweeps are **idempotent and safe to run concurrently** on every instance: closing an
+ * already-`Closed` session is a no-op, and the close path is last-writer-wins. Both page with keyset
+ * (`AfterKey`) pagination per the deep-pagination guide so a large backlog can't blow up memory.
+ */
+export declare class SessionJanitor extends BaseSingleton<SessionJanitor> implements IShutdownable {
+    private _config;
+    private _sweepTimer;
+    private _sweepRunning;
+    private _registered;
+    private _provider;
+    private _systemUser;
+    private readonly sessionManager;
+    protected constructor();
+    /** Process-wide singleton accessor (Global Object Store backed via {@link BaseSingleton}). */
+    static get Instance(): SessionJanitor;
+    /** Identifier surfaced in graceful-shutdown logs. */
+    readonly ShutdownName = "SessionJanitor";
+    /** Overrides default tuning. Safe to call before or after {@link Start}. */
+    Configure(config: Partial<SessionJanitorConfig>): void;
+    /**
+     * Run own-host startup recovery once, then schedule the periodic staleness sweep. Idempotent:
+     * a second call does not stack a second timer. Captures the provider + system user so the timer
+     * callback can run without re-supplying them.
+     */
+    Start(provider: IMetadataProvider, systemUser: UserInfo, intervalMs?: number): Promise<void>;
+    /** Stops the periodic sweep timer. Idempotent. Part of {@link IShutdownable}. */
+    Stop(): void;
+    /**
+     * {@link IShutdownable}: clear the timer, then drain this host's own live sessions so a
+     * graceful stop never strands `Active`/`Idle` rows for the next boot's janitor to mop up.
+     * Drained sessions are stamped `CloseReason = 'Shutdown'` (vs. `'Janitor'` for crash orphans),
+     * so the dashboards can tell a clean redeploy from a reconciled crash. Never throws; the drain
+     * is skipped when {@link Start} was never called (no captured provider/user).
+     */
+    Shutdown(): Promise<void>;
+    /**
+     * Close every `Active`/`Idle` session owned by **this exact host instance** (current boot),
+     * stamping `CloseReason = 'Shutdown'`. Invoked from {@link Shutdown} during the graceful
+     * shutdown drain; exposed publicly for tests and for hosts that want to drain explicitly.
+     * Returns the number of sessions closed.
+     */
+    RunShutdownDrain(provider: IMetadataProvider, systemUser: UserInfo): Promise<number>;
+    /**
+     * Force-close any `Active`/`Idle` session left behind by a *previous boot of this host*
+     * (matching hostname prefix, differing `bootId`). Returns the number of sessions closed.
+     */
+    RunStartupRecovery(provider: IMetadataProvider, systemUser: UserInfo): Promise<number>;
+    /**
+     * Force-close any `Active`/`Idle` session whose `LastActiveAt` is older than the configured
+     * close threshold, regardless of host. Idempotent and concurrency-safe. Returns the count closed.
+     */
+    RunStalenessSweep(provider: IMetadataProvider, systemUser: UserInfo): Promise<number>;
+    /** Register for graceful shutdown exactly once. */
+    private ensureRegistered;
+    /** Schedule the periodic staleness sweep, exactly once. Timer is unref'd so it never blocks exit. */
+    private scheduleSweep;
+    /** Timer tick: run the staleness sweep under the captured provider/user, guarding overlap. */
+    private periodicSweep;
+    /**
+     * Page through every session matching `filter` with keyset (`AfterKey`) pagination and close each
+     * via {@link SessionManager.CloseSession}, stamping `closeReason` on every row it transitions.
+     * Returns the number successfully closed. A `Closed`-by-now row (raced by another instance) is a
+     * harmless no-op that keeps its original reason.
+     */
+    private sweepAndClose;
+    /** Fetch one keyset page of matching sessions, or null on a load failure (logged). */
+    private fetchPage;
+}
+//# sourceMappingURL=SessionJanitor.d.ts.map

package/dist/agentSessions/SessionJanitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionJanitor.d.ts","sourceRoot":"","sources":["../../src/agentSessions/SessionJanitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACH,iBAAiB,EACjB,QAAQ,EAMX,MAAM,sBAAsB,CAAC;AAW9B,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACjC,0GAA0G;IAC1G,qBAAqB,EAAE,MAAM,CAAC;IAC9B,+FAA+F;IAC/F,eAAe,EAAE,MAAM,CAAC;CAC3B;AAOD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,cAAe,SAAQ,aAAa,CAAC,cAAc,CAAE,YAAW,aAAa;IACtF,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IAEvD,SAAS;IAIT,8FAA8F;IAC9F,WAAkB,QAAQ,IAAI,cAAc,CAE3C;IAED,qDAAqD;IACrD,SAAgB,YAAY,oBAAoB;IAEhD,4EAA4E;IACrE,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAI7D;;;;OAIG;IACU,KAAK,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzG,iFAAiF;IAC1E,IAAI,IAAI,IAAI;IAOnB;;;;;;OAMG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtC;;;;;OAKG;IACU,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAUjG;;;OAGG;IACU,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAcnG;;;OAGG;IACU,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAYlG,mDAAmD;IACnD,OAAO,CAAC,gBAAgB;IAOxB,qGAAqG;IACrG,OAAO,CAAC,aAAa;IAQrB,8FAA8F;YAChF,aAAa;IAc3B;;;;;OAKG;YACW,aAAa;IAgC3B,sFAAsF;YACxE,SAAS;CAqB1B"}

package/dist/agentSessions/SessionJanitor.js

@@ -0,0 +1,222 @@
+import { BaseSingleton, ShutdownRegistry } from '@memberjunction/global';
+import { CompositeKey, RunView, LogError, LogStatus, } from '@memberjunction/core';
+import { GetHostInstanceID, GetHostNamePrefix } from './HostInstance.js';
+import { SessionManager } from './SessionManager.js';
+/** Entity name for session rows (kept in sync with {@link SessionManager}). */
+const SESSION_ENTITY = 'MJ: AI Agent Sessions';
+/** Rows fetched per keyset page during a sweep. Small enough to bound memory on a large backlog. */
+const SWEEP_PAGE_SIZE = 200;
+const DEFAULT_CONFIG = {
+    closeThresholdMinutes: 15,
+    sweepIntervalMs: 60_000,
+};
+/**
+ * `BaseSingleton` background reconciler that keeps the durable `AIAgentSession` state from drifting
+ * away from volatile process reality. A crash/redeploy vaporizes a host's in-memory sockets but
+ * leaves its session rows reading `Active`/`Idle` forever; the janitor force-closes those orphans.
+ *
+ * Two sweeps, both writing through {@link SessionManager.CloseSession} so Record Changes captures
+ * each transition and channel rows are disconnected consistently:
+ *
+ * 1. **Own-host recovery ({@link RunStartupRecovery})** — run once at boot. Closes any `Active`/`Idle`
+ *    session whose `HostInstanceID` belongs to a *previous* boot of *this* host (same hostname prefix,
+ *    different `bootId`). Primary defense against the "Active forever" leak after a restart.
+ * 2. **Global staleness sweep ({@link RunStalenessSweep})** — run periodically on every instance.
+ *    Closes any `Active`/`Idle` session whose `LastActiveAt` is older than `closeThresholdMinutes`,
+ *    regardless of host. Catches sessions whose owner died without a clean reboot (OOM, scaled-down pod).
+ *
+ * Both sweeps stamp `CloseReason = 'Janitor'`. A third, shutdown-time path —
+ * {@link RunShutdownDrain}, invoked from {@link Shutdown} during the graceful ShutdownRegistry
+ * drain — closes this exact host instance's own live sessions with `CloseReason = 'Shutdown'`.
+ *
+ * Both sweeps are **idempotent and safe to run concurrently** on every instance: closing an
+ * already-`Closed` session is a no-op, and the close path is last-writer-wins. Both page with keyset
+ * (`AfterKey`) pagination per the deep-pagination guide so a large backlog can't blow up memory.
+ */
+export class SessionJanitor extends BaseSingleton {
+    constructor() {
+        super();
+        this._config = DEFAULT_CONFIG;
+        this._sweepTimer = null;
+        this._sweepRunning = false;
+        this._registered = false;
+        this._provider = null;
+        this._systemUser = null;
+        this.sessionManager = new SessionManager();
+        /** Identifier surfaced in graceful-shutdown logs. */
+        this.ShutdownName = 'SessionJanitor';
+    }
+    /** Process-wide singleton accessor (Global Object Store backed via {@link BaseSingleton}). */
+    static get Instance() {
+        return super.getInstance();
+    }
+    /** Overrides default tuning. Safe to call before or after {@link Start}. */
+    Configure(config) {
+        this._config = { ...this._config, ...config };
+    }
+    /**
+     * Run own-host startup recovery once, then schedule the periodic staleness sweep. Idempotent:
+     * a second call does not stack a second timer. Captures the provider + system user so the timer
+     * callback can run without re-supplying them.
+     */
+    async Start(provider, systemUser, intervalMs) {
+        this._provider = provider;
+        this._systemUser = systemUser;
+        if (intervalMs != null) {
+            this._config = { ...this._config, sweepIntervalMs: intervalMs };
+        }
+        this.ensureRegistered();
+        await this.RunStartupRecovery(provider, systemUser);
+        this.scheduleSweep();
+    }
+    /** Stops the periodic sweep timer. Idempotent. Part of {@link IShutdownable}. */
+    Stop() {
+        if (this._sweepTimer) {
+            clearInterval(this._sweepTimer);
+            this._sweepTimer = null;
+        }
+    }
+    /**
+     * {@link IShutdownable}: clear the timer, then drain this host's own live sessions so a
+     * graceful stop never strands `Active`/`Idle` rows for the next boot's janitor to mop up.
+     * Drained sessions are stamped `CloseReason = 'Shutdown'` (vs. `'Janitor'` for crash orphans),
+     * so the dashboards can tell a clean redeploy from a reconciled crash. Never throws; the drain
+     * is skipped when {@link Start} was never called (no captured provider/user).
+     */
+    async Shutdown() {
+        this.Stop();
+        if (this._provider && this._systemUser) {
+            try {
+                await this.RunShutdownDrain(this._provider, this._systemUser);
+            }
+            catch (err) {
+                LogError(`SessionJanitor shutdown drain failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    /**
+     * Close every `Active`/`Idle` session owned by **this exact host instance** (current boot),
+     * stamping `CloseReason = 'Shutdown'`. Invoked from {@link Shutdown} during the graceful
+     * shutdown drain; exposed publicly for tests and for hosts that want to drain explicitly.
+     * Returns the number of sessions closed.
+     */
+    async RunShutdownDrain(provider, systemUser) {
+        const current = GetHostInstanceID().replace(/'/g, "''");
+        const filter = `Status IN ('Active','Idle') AND HostInstanceID = '${current}'`;
+        const closed = await this.sweepAndClose(filter, provider, systemUser, 'Shutdown');
+        if (closed > 0) {
+            LogStatus(`[SessionJanitor] Shutdown drain closed ${closed} live session(s) owned by this host instance`);
+        }
+        return closed;
+    }
+    /**
+     * Force-close any `Active`/`Idle` session left behind by a *previous boot of this host*
+     * (matching hostname prefix, differing `bootId`). Returns the number of sessions closed.
+     */
+    async RunStartupRecovery(provider, systemUser) {
+        const prefix = GetHostNamePrefix().replace(/'/g, "''");
+        const current = GetHostInstanceID().replace(/'/g, "''");
+        const filter = `Status IN ('Active','Idle') ` +
+            `AND HostInstanceID LIKE '${prefix}%' ` +
+            `AND HostInstanceID <> '${current}'`;
+        const closed = await this.sweepAndClose(filter, provider, systemUser, 'Janitor');
+        if (closed > 0) {
+            LogStatus(`[SessionJanitor] Startup recovery closed ${closed} orphaned session(s) from a prior boot of this host`);
+        }
+        return closed;
+    }
+    /**
+     * Force-close any `Active`/`Idle` session whose `LastActiveAt` is older than the configured
+     * close threshold, regardless of host. Idempotent and concurrency-safe. Returns the count closed.
+     */
+    async RunStalenessSweep(provider, systemUser) {
+        const cutoffIso = new Date(Date.now() - this._config.closeThresholdMinutes * 60_000).toISOString();
+        const filter = `Status IN ('Active','Idle') AND LastActiveAt < '${cutoffIso}'`;
+        const closed = await this.sweepAndClose(filter, provider, systemUser, 'Janitor');
+        if (closed > 0) {
+            LogStatus(`[SessionJanitor] Staleness sweep closed ${closed} stale session(s) (>${this._config.closeThresholdMinutes}m idle)`);
+        }
+        return closed;
+    }
+    // ----- internals -------------------------------------------------------------------------
+    /** Register for graceful shutdown exactly once. */
+    ensureRegistered() {
+        if (!this._registered) {
+            ShutdownRegistry.Instance.Register(this);
+            this._registered = true;
+        }
+    }
+    /** Schedule the periodic staleness sweep, exactly once. Timer is unref'd so it never blocks exit. */
+    scheduleSweep() {
+        if (this._sweepTimer) {
+            return;
+        }
+        this._sweepTimer = setInterval(() => void this.periodicSweep(), this._config.sweepIntervalMs);
+        this._sweepTimer.unref?.();
+    }
+    /** Timer tick: run the staleness sweep under the captured provider/user, guarding overlap. */
+    async periodicSweep() {
+        if (this._sweepRunning || !this._provider || !this._systemUser) {
+            return;
+        }
+        this._sweepRunning = true;
+        try {
+            await this.RunStalenessSweep(this._provider, this._systemUser);
+        }
+        catch (err) {
+            LogError(`SessionJanitor periodic sweep failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            this._sweepRunning = false;
+        }
+    }
+    /**
+     * Page through every session matching `filter` with keyset (`AfterKey`) pagination and close each
+     * via {@link SessionManager.CloseSession}, stamping `closeReason` on every row it transitions.
+     * Returns the number successfully closed. A `Closed`-by-now row (raced by another instance) is a
+     * harmless no-op that keeps its original reason.
+     */
+    async sweepAndClose(filter, provider, systemUser, closeReason) {
+        let closedCount = 0;
+        let afterKey;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const page = await this.fetchPage(filter, afterKey, provider, systemUser);
+            if (page == null) {
+                break; // load failure already logged
+            }
+            if (page.length === 0) {
+                break;
+            }
+            for (const session of page) {
+                const closed = await this.sessionManager.CloseSession(session.ID, systemUser, provider, closeReason);
+                if (closed) {
+                    closedCount++;
+                }
+            }
+            if (page.length < SWEEP_PAGE_SIZE) {
+                break; // partial page => end of data
+            }
+            afterKey = CompositeKey.FromID(page[page.length - 1].ID);
+        }
+        return closedCount;
+    }
+    /** Fetch one keyset page of matching sessions, or null on a load failure (logged). */
+    async fetchPage(filter, afterKey, provider, systemUser) {
+        const params = {
+            EntityName: SESSION_ENTITY,
+            ExtraFilter: filter,
+            AfterKey: afterKey,
+            MaxRows: SWEEP_PAGE_SIZE,
+            ResultType: 'entity_object',
+        };
+        const rv = RunView.FromMetadataProvider(provider);
+        const result = await rv.RunView(params, systemUser);
+        if (!result.Success) {
+            LogError(`SessionJanitor sweep load failed: ${result.ErrorMessage}`);
+            return null;
+        }
+        return result.Results;
+    }
+}
+//# sourceMappingURL=SessionJanitor.js.map

package/dist/agentSessions/SessionJanitor.js.map

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

package/dist/agentSessions/SessionManager.d.ts

@@ -0,0 +1,142 @@
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { MJAIAgentSessionEntity } from '@memberjunction/core-entities';
+/**
+ * Inputs for {@link SessionManager.CreateSession}. `conversationID`/`lastSessionID`/`config`
+ * are optional — when no `conversationID` is supplied a fresh Conversation is created and linked.
+ */
+export interface CreateSessionInput {
+    /** The agent the session will run. Authorized via `CanRun` before any row is written. */
+    agentID: string;
+    /** The owning user. Persisted as `AIAgentSession.UserID`; enforced on every inbound envelope. */
+    userID: string;
+    /** Existing conversation to attach to. If omitted, a new one is created and linked. */
+    conversationID?: string;
+    /** Prior (closed) session being resumed — chained via `LastSessionID`. */
+    lastSessionID?: string;
+    /** Free-form, low-traffic session state. Serialized verbatim into `AIAgentSession.Config`. */
+    config?: string;
+}
+/**
+ * Why a session was closed — persisted to `AIAgentSession.CloseReason` alongside the
+ * `Status = 'Closed'` transition so the admin dashboards can distinguish a user hanging up
+ * (`Explicit`) from janitor reconciliation (`Janitor`), a graceful host drain (`Shutdown`),
+ * or a failure-path teardown (`Error`). `NULL` in the column means "legacy/unknown" — rows
+ * closed before this column existed.
+ */
+export type SessionCloseReason = 'Explicit' | 'Janitor' | 'Shutdown' | 'Error';
+/**
+ * Thrown by {@link SessionManager.CreateSession} when the caller lacks `CanRun` on the target
+ * agent. No session row is created — denial happens before any write. Distinct error type so the
+ * resolver layer can map it to an authorization-shaped GraphQL error rather than a generic failure.
+ */
+export declare class SessionAuthorizationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Server-side lifecycle manager for `AIAgentSession` **records** (not the media/socket transport —
+ * that arrives in P5). Stateless with respect to the caller: every method takes the request's
+ * `contextUser` and request-scoped `IMetadataProvider` so all entity operations run under the
+ * correct identity/provider and never pin the process-global provider.
+ *
+ * The only in-memory state it holds is a small per-session last-heartbeat-write timestamp map used
+ * purely to coalesce {@link Heartbeat} writes; it carries no user or provider state across calls.
+ *
+ * Responsibilities:
+ * - **Create** — authorize (`CanRun`), optionally mint a Conversation, persist an `Active` session.
+ * - **Close** — terminal transition; disconnect channels; idempotent.
+ * - **Heartbeat** — coalesced `LastActiveAt` bump; reactivates `Idle → Active`.
+ * - **MarkIdle** — `Active → Idle` transition when the last channel goes quiet.
+ *
+ * @remarks
+ * P5 will extend {@link CloseSession} to also abort any in-flight `AIAgentRun` (via its cancellation
+ * token) and call `ClientToolRequestManager.ClearSession(...)`; those resources don't exist yet at
+ * this layer, so close here only reconciles the durable record + channel rows.
+ */
+export declare class SessionManager {
+    /** session ID (lowercased) → epoch ms of its last persisted `LastActiveAt` write. */
+    private heartbeatLastWrite;
+    /**
+     * Authorize and create a new session. Flow:
+     * 1. `CanRun` check on the agent — denied → {@link SessionAuthorizationError}, no row written.
+     * 2. Resolve the conversation (use the supplied one, or create+link a fresh Conversation).
+     * 3. Persist the `AIAgentSession` as `Active`, stamped with this host and `LastActiveAt = now`.
+     *
+     * @returns the saved {@link MJAIAgentSessionEntity}.
+     * @throws {SessionAuthorizationError} when the user may not run the agent.
+     * @throws {Error} when conversation creation or session save fails.
+     */
+    CreateSession(input: CreateSessionInput, contextUser: UserInfo, provider: IMetadataProvider): Promise<MJAIAgentSessionEntity>;
+    /**
+     * Close a session (terminal). Sets `Status = 'Closed'` + `ClosedAt = now` + `CloseReason`, then
+     * disconnects all of its channel rows. Idempotent: closing an already-`Closed` session is a
+     * no-op that returns `true` (and never overwrites the original `CloseReason`). A
+     * missing/unloadable session returns `false`.
+     *
+     * @param closeReason Why the session is being closed. **Defaults to `'Explicit'`** so existing
+     *   call sites (the user-initiated close mutations) stamp the common case without modification;
+     *   background callers (janitor sweeps, shutdown drain, error teardowns) must pass their reason
+     *   explicitly. `NULL` rows remain only for legacy data closed before the column existed.
+     *
+     * @remarks P5 adds in-flight-run abort + `ClientToolRequestManager.ClearSession` here.
+     */
+    CloseSession(agentSessionID: string, contextUser: UserInfo, provider: IMetadataProvider, closeReason?: SessionCloseReason): Promise<boolean>;
+    /**
+     * Notifies the server-side channel-plugin host that a session started, so it can resolve the
+     * ACTIVE `MJ: AI Agent Channels` rows' `ServerPluginClass` plugins (one fresh instance per
+     * channel, per session) and fire their start hooks. Strictly best-effort: the host itself
+     * never throws, and this guard makes session creation immune to any plugin-layer surprise.
+     */
+    private notifyChannelPluginsSessionStarted;
+    /**
+     * Notifies the server-side channel-plugin host that a session closed (fires each plugin's
+     * `OnSessionClosed` hook and schedules disposal). Invoked from EVERY close provenance —
+     * explicit hang-up, janitor sweeps, shutdown drain, and error teardowns all funnel through
+     * {@link CloseSession}. Strictly best-effort, same posture as the start notification.
+     */
+    private notifyChannelPluginsSessionClosed;
+    /**
+     * Finalizes the co-agent observability runs a realtime voice session stored in its `Config_`
+     * (see `RealtimeClientSessionResolver`). No-op when the config carries no run ids. Tolerant: a
+     * malformed config or a finalize failure is swallowed so it can never break session close.
+     */
+    private finalizeObservabilityRuns;
+    /** Parses the session's `Config_` for observability run ids; returns an empty config on any error. */
+    private parseSessionRunConfig;
+    /**
+     * Record activity on a session. Coalesces persisted writes so at most one `LastActiveAt` update
+     * lands per session per {@link HEARTBEAT_MIN_WRITE_INTERVAL_MS}; intervening calls return `true`
+     * without touching the DB. Reactivates an `Idle` session to `Active`. A `Closed` session is not
+     * reactivated (returns `false`).
+     */
+    Heartbeat(agentSessionID: string, contextUser: UserInfo, provider: IMetadataProvider): Promise<boolean>;
+    /**
+     * Transition an `Active` session to `Idle` (e.g. when its last channel disconnects). No-op when
+     * the session is already `Idle` or `Closed`. Returns `true` on success / no-op-needed.
+     */
+    MarkIdle(agentSessionID: string, contextUser: UserInfo, provider: IMetadataProvider): Promise<boolean>;
+    /** Throws {@link SessionAuthorizationError} unless the user has `CanRun` on the agent. */
+    private assertCanRun;
+    /** Creates and links a new Conversation for the session, returning its ID. */
+    private createConversation;
+    /** Persists the new session row as `Active` and returns the saved entity. */
+    private persistNewSession;
+    /** Loads a session entity by ID, returning null when it cannot be loaded. */
+    private loadSession;
+    /** Sets `Closed` + `ClosedAt` + `CloseReason` and saves. Returns the save result. */
+    private markSessionClosed;
+    /** Marks every channel row of the session `Disconnected` (with `DisconnectedAt`), if not already. */
+    private disconnectChannels;
+    /** True once the per-session coalescing window has elapsed since the last persisted write. */
+    private heartbeatWriteDue;
+    /**
+     * Whether this heartbeat must write regardless of the coalescing window. We force a write the
+     * first time we see a session (no cached timestamp) so an `Idle → Active` reactivation is never
+     * swallowed by coalescing.
+     */
+    private shouldForceWrite;
+    /** Loads, bumps `LastActiveAt`, reactivates `Idle → Active`, saves, and records the write time. */
+    private persistHeartbeat;
+    /** Saves an entity, logging `CompleteMessage` on failure. Returns the boolean save result. */
+    private saveOrLog;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/agentSessions/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/agentSessions/SessionManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAqB,MAAM,sBAAsB,CAAC;AACtF,OAAO,EACH,sBAAsB,EAGzB,MAAM,+BAA+B,CAAC;AAsBvC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAE/E;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI9B;AASD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAc;IACvB,qFAAqF;IACrF,OAAO,CAAC,kBAAkB,CAA6B;IAEvD;;;;;;;;;OASG;IACU,aAAa,CACtB,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,QAAQ,EACrB,QAAQ,EAAE,iBAAiB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAWlC;;;;;;;;;;;;OAYG;IACU,YAAY,CACrB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,QAAQ,EACrB,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,GAAE,kBAA+B,GAC7C,OAAO,CAAC,OAAO,CAAC;IAyBnB;;;;;OAKG;YACW,kCAAkC;IAqBhD;;;;;OAKG;YACW,iCAAiC;IAW/C;;;;OAIG;YACW,yBAAyB;IAuBvC,sGAAsG;IACtG,OAAO,CAAC,qBAAqB;IAgB7B;;;;;OAKG;IACU,SAAS,CAClB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,QAAQ,EACrB,QAAQ,EAAE,iBAAiB,GAC5B,OAAO,CAAC,OAAO,CAAC;IASnB;;;OAGG;IACU,QAAQ,CACjB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,QAAQ,EACrB,QAAQ,EAAE,iBAAiB,GAC5B,OAAO,CAAC,OAAO,CAAC;IAcnB,0FAA0F;YAC5E,YAAY;IAS1B,8EAA8E;YAChE,kBAAkB;IAmBhC,6EAA6E;YAC/D,iBAAiB;IA0B/B,6EAA6E;YAC/D,WAAW;IAUzB,qFAAqF;YACvE,iBAAiB;IAU/B,qGAAqG;YACvF,kBAAkB;IAwBhC,8FAA8F;IAC9F,OAAO,CAAC,iBAAiB;IAKzB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAIxB,mGAAmG;YACrF,gBAAgB;IAoB9B,8FAA8F;YAChF,SAAS;CAU1B"}