@memberjunction/server 6.2.0-edge.6 → 6.2.0-edge.8

package/dist/agentSessions/BridgeHostInstance.d.ts

@@ -1,4 +1,5 @@
 import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { type BridgeReconcilerSettings } from '../backgroundSweepConfigUnits.js';
 /**
  * Gives the realtime bridge engine (`AIBridgeEngine`) this MJAPI instance's identity, the one its agent-session rows
  * carry: `hostname:port:pid:bootId` ({@link GetCurrentHostInstance}). The engine stamps it into the `HostInstanceID`
@@ -11,8 +12,11 @@ import { IMetadataProvider, UserInfo } from '@memberjunction/core';
  */
 export declare function BindBridgeEngineHostInstance(): void;
 /**
- * Starts the realtime bridge engine's orphan reconcile: now, then every 10 minutes, it closes the bridges an earlier
- * boot of this instance left `Connecting` or `Connected` (reason `Janitor`) and finalizes their co-agent runs.
+ * Starts the realtime bridge engine's orphan reconcile: now, then every `settings.sweepIntervalMs` (10 minutes by
+ * default), it closes the bridges an earlier boot of this instance left `Connecting` or `Connected` (reason `Janitor`)
+ * and finalizes their co-agent runs. With `settings.enabled` false it reconciles once now and schedules no repeat, so an
+ * idle server sends no periodic queries for it (`agentSessions.bridgeReconciler`; see the Serverless Database
+ * Auto-Pause guide).
  *
  * `Serve` calls it once the server listens on its port, where it starts the session janitor. Holding the port is what
  * makes another boot of this instance a process that has ended; before that, an MJAPI started on a port another MJAPI
@@ -20,6 +24,7 @@ export declare function BindBridgeEngineHostInstance(): void;
  *
  * @param provider The server's metadata provider, for the reads and writes.
  * @param systemUser The user the writes run as.
+ * @param settings Whether to repeat the reconcile, and how often. Defaults to the shipped settings.
  */
-export declare function StartBridgeOrphanReconciliation(provider: IMetadataProvider, systemUser: UserInfo): void;
+export declare function StartBridgeOrphanReconciliation(provider: IMetadataProvider, systemUser: UserInfo, settings?: BridgeReconcilerSettings): void;
 //# sourceMappingURL=BridgeHostInstance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BridgeHostInstance.d.ts","sourceRoot":"","sources":["../../src/agentSessions/BridgeHostInstance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAInE;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,GAAG,IAAI,CAEvG"}
+{"version":3,"file":"BridgeHostInstance.d.ts","sourceRoot":"","sources":["../../src/agentSessions/BridgeHostInstance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAsC,KAAK,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAErH;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC3C,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,QAAQ,EACpB,QAAQ,GAAE,wBAA6D,GACxE,IAAI,CAQN"}

package/dist/agentSessions/BridgeHostInstance.js

@@ -1,5 +1,7 @@
+import { LogError } from '@memberjunction/core';
 import { AIBridgeEngine } from '@memberjunction/ai-bridge-server';
 import { GetCurrentHostInstance } from './HostInstance.js';
+import { DEFAULT_BRIDGE_RECONCILER_SETTINGS } from '../backgroundSweepConfigUnits.js';
 /**
  * Gives the realtime bridge engine (`AIBridgeEngine`) this MJAPI instance's identity, the one its agent-session rows
  * carry: `hostname:port:pid:bootId` ({@link GetCurrentHostInstance}). The engine stamps it into the `HostInstanceID`
@@ -14,8 +16,11 @@ export function BindBridgeEngineHostInstance() {
     AIBridgeEngine.Instance.SetHostInstanceIdentity(GetCurrentHostInstance());
 }
 /**
- * Starts the realtime bridge engine's orphan reconcile: now, then every 10 minutes, it closes the bridges an earlier
- * boot of this instance left `Connecting` or `Connected` (reason `Janitor`) and finalizes their co-agent runs.
+ * Starts the realtime bridge engine's orphan reconcile: now, then every `settings.sweepIntervalMs` (10 minutes by
+ * default), it closes the bridges an earlier boot of this instance left `Connecting` or `Connected` (reason `Janitor`)
+ * and finalizes their co-agent runs. With `settings.enabled` false it reconciles once now and schedules no repeat, so an
+ * idle server sends no periodic queries for it (`agentSessions.bridgeReconciler`; see the Serverless Database
+ * Auto-Pause guide).
  *
  * `Serve` calls it once the server listens on its port, where it starts the session janitor. Holding the port is what
  * makes another boot of this instance a process that has ended; before that, an MJAPI started on a port another MJAPI
@@ -23,8 +28,13 @@ export function BindBridgeEngineHostInstance() {
  *
  * @param provider The server's metadata provider, for the reads and writes.
  * @param systemUser The user the writes run as.
+ * @param settings Whether to repeat the reconcile, and how often. Defaults to the shipped settings.
  */
-export function StartBridgeOrphanReconciliation(provider, systemUser) {
-    AIBridgeEngine.Instance.StartOrphanReconciliation(systemUser, provider);
+export function StartBridgeOrphanReconciliation(provider, systemUser, settings = DEFAULT_BRIDGE_RECONCILER_SETTINGS) {
+    if (settings.enabled) {
+        AIBridgeEngine.Instance.StartOrphanReconciliation(systemUser, provider, settings.sweepIntervalMs);
+        return;
+    }
+    void AIBridgeEngine.Instance.ReconcileOrphans(systemUser, provider).catch((err) => LogError(`[AIBridgeEngine] orphan reconciliation failed: ${err instanceof Error ? err.message : String(err)}`));
 }
 //# sourceMappingURL=BridgeHostInstance.js.map

package/dist/agentSessions/BridgeHostInstance.js.map

@@ -1 +1 @@
-{"version":3,"file":"BridgeHostInstance.js","sourceRoot":"","sources":["../../src/agentSessions/BridgeHostInstance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B;IACxC,cAAc,CAAC,QAAQ,CAAC,uBAAuB,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,+BAA+B,CAAC,QAA2B,EAAE,UAAoB;IAC7F,cAAc,CAAC,QAAQ,CAAC,yBAAyB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC5E,CAAC"}
+{"version":3,"file":"BridgeHostInstance.js","sourceRoot":"","sources":["../../src/agentSessions/BridgeHostInstance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,QAAQ,EAAY,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,kCAAkC,EAAiC,MAAM,kCAAkC,CAAC;AAErH;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B;IACxC,cAAc,CAAC,QAAQ,CAAC,uBAAuB,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,+BAA+B,CAC3C,QAA2B,EAC3B,UAAoB,EACpB,WAAqC,kCAAkC;IAEvE,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,cAAc,CAAC,QAAQ,CAAC,yBAAyB,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;QAClG,OAAO;IACX,CAAC;IACD,KAAK,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAC9E,QAAQ,CAAC,kDAAkD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CACjH,CAAC;AACN,CAAC"}

package/dist/agentSessions/HandoffOfferExpiry.d.ts

@@ -0,0 +1,10 @@
+import type { HandoffOfferSweepSettings } from '../backgroundSweepConfigUnits.js';
+/**
+ * Applies `agentSessions.handoffOfferExpiry` to the process-wide handoff offer registry. The registry
+ * starts its expiry sweep (a read of `MJ: Interaction Offers` every 15 seconds) as soon as it loads, on
+ * every MJAPI whatever its role; this either stops that sweep, so an idle server sends no periodic
+ * query for it, or restarts it on the configured interval. Overdue offers still read as expired when
+ * the sweep is off. See the Serverless Database Auto-Pause guide.
+ */
+export declare function ApplyHandoffOfferExpirySettings(settings: HandoffOfferSweepSettings): void;
+//# sourceMappingURL=HandoffOfferExpiry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HandoffOfferExpiry.d.ts","sourceRoot":"","sources":["../../src/agentSessions/HandoffOfferExpiry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAElF;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAOzF"}

package/dist/agentSessions/HandoffOfferExpiry.js

@@ -0,0 +1,18 @@
+import { HandoffOfferRegistry } from '@memberjunction/livekit-room-server';
+/**
+ * Applies `agentSessions.handoffOfferExpiry` to the process-wide handoff offer registry. The registry
+ * starts its expiry sweep (a read of `MJ: Interaction Offers` every 15 seconds) as soon as it loads, on
+ * every MJAPI whatever its role; this either stops that sweep, so an idle server sends no periodic
+ * query for it, or restarts it on the configured interval. Overdue offers still read as expired when
+ * the sweep is off. See the Serverless Database Auto-Pause guide.
+ */
+export function ApplyHandoffOfferExpirySettings(settings) {
+    const registry = HandoffOfferRegistry.Instance;
+    if (settings.enabled) {
+        registry.StartPeriodicSweep(settings.sweepIntervalMs);
+    }
+    else {
+        registry.StopPeriodicSweep();
+    }
+}
+//# sourceMappingURL=HandoffOfferExpiry.js.map

package/dist/agentSessions/HandoffOfferExpiry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandoffOfferExpiry.js","sourceRoot":"","sources":["../../src/agentSessions/HandoffOfferExpiry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAG3E;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAAC,QAAmC;IAC/E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC;IAC/C,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACJ,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IACjC,CAAC;AACL,CAAC"}

package/dist/agentSessions/ReturningVisitorRecap.js

@@ -114,6 +114,7 @@ async function recapAlreadyExists(conversationId, contextUser) {
         ExtraFilter: `SourceConversationID = '${conversationId}' AND IsAutoGenerated = 1 AND Type = 'Context'`,
         Fields: ['ID'],
         MaxRows: 1,
+        SkipTotalRowCount: true,
         ResultType: 'simple',
     }, contextUser);
     return result.Success && (result.Results?.length ?? 0) > 0;

package/dist/agentSessions/ReturningVisitorRecap.js.map

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

package/dist/agentSessions/SessionJanitor.d.ts

@@ -1,6 +1,7 @@
 import { BaseSingleton, IShutdownable } from '@memberjunction/global';
 import { DatabaseProviderBase, IMetadataProvider, UserInfo } from '@memberjunction/core';
 import { HostInstanceIdentity } from './HostInstance.js';
+import type { SessionJanitorSettings } from '../backgroundSweepConfigUnits.js';
 /** 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. */
@@ -39,9 +40,12 @@ export interface SessionJanitorConfig {
  *    `closeThresholdMinutes`, regardless of host. Catches sessions whose owner died without a clean
  *    reboot (OOM, scaled-down pod).
  * 3. **Max-duration sweep ({@link RunMaxDurationSweep})** — run on every periodic tick after the
- *    staleness sweep. Closes any session past its stored hard deadline (the public voice cost cap).
+ *    staleness sweep. Closes any session past its stored hard deadline (the public voice cost cap), and
+ *    any deadline-carrying session whose idle moment has passed; it stamps that row `'Idle'` when the idle
+ *    moment came before the deadline.
  *
- * The close sweeps stamp `CloseReason = 'Janitor'`. A shutdown-time path — {@link RunShutdownDrain},
+ * Startup recovery stamps `CloseReason = 'Janitor'`; the staleness and max-duration sweeps stamp `'Idle'` or
+ * `'TimeLimit'`, whichever expiry moment passed first ({@link ExpiryCloseReason}). A 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'`.
  *
@@ -112,6 +116,21 @@ export declare class SessionJanitor extends BaseSingleton<SessionJanitor> implem
      * recording recovery calls the shard ledger's stored procedures.
      */
     Start(provider: DatabaseProviderBase, systemUser: UserInfo, intervalMs?: number): Promise<void>;
+    /**
+     * Starts the janitor the way the host's `agentSessions.janitor` settings ask: applies the interval
+     * and close threshold, then {@link Start} when enabled, or {@link StartRecoveryOnly} when not.
+     * Throws (before doing any work) on an invalid interval or threshold; see {@link Configure}.
+     */
+    StartWithSettings(settings: SessionJanitorSettings, provider: DatabaseProviderBase, systemUser: UserInfo): Promise<void>;
+    /**
+     * {@link Start} without the periodic tick, for hosts that turned the janitor off: run own-host
+     * startup recovery once and register for the graceful-shutdown drain, but schedule nothing, so an
+     * idle process issues no periodic queries. Stale-session, max-duration and recording-recovery
+     * sweeps then do not run in this process. Stops a tick an earlier {@link Start} scheduled.
+     */
+    StartRecoveryOnly(provider: DatabaseProviderBase, systemUser: UserInfo): Promise<void>;
+    /** Whether the periodic tick is currently scheduled (diagnostics and tests). */
+    get IsSweepScheduled(): boolean;
     /**
      * Stops the periodic tick and keeps any new recording recovery pass from starting until the next
      * {@link Start}, including one a tick already in progress would have started. A pass that is already
@@ -122,7 +141,7 @@ export declare class SessionJanitor extends BaseSingleton<SessionJanitor> implem
      * {@link IShutdownable}: stop 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, then wait
      * (at most {@link RECOVERY_SHUTDOWN_WAIT_MS}) for an in-flight recording recovery pass.
-     * Drained sessions are stamped `CloseReason = 'Shutdown'` (vs. `'Janitor'` for crash orphans),
+     * Drained sessions are stamped `CloseReason = 'Shutdown'` (vs. `'Janitor'` for crash orphans from an earlier boot),
      * 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).
      */
@@ -147,7 +166,10 @@ export declare class SessionJanitor extends BaseSingleton<SessionJanitor> implem
     RunStartupRecovery(provider: IMetadataProvider, systemUser: UserInfo, hostInstance?: HostInstanceIdentity): 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.
+     * close threshold, regardless of host. Stamped `'Idle'`, or `'TimeLimit'` when the row's authored deadline
+     * passed before its idle moment ({@link ExpiryCloseReason}). A row the SQL judged stale is never skipped:
+     * when its `LastActiveAt` will not parse it closes as `'Idle'` with a `LogError` ({@link staleRowCloseReason}).
+     * Idempotent and concurrency-safe. Returns the count closed.
      */
     RunStalenessSweep(provider: IMetadataProvider, systemUser: UserInfo): Promise<number>;
     /**
@@ -158,7 +180,8 @@ export declare class SessionJanitor extends BaseSingleton<SessionJanitor> implem
      *
      * Only sessions that CARRY a deadline are loaded (a cheap `Config_ LIKE` pre-filter), then the exact
      * ISO deadline is parsed and compared in JS (`Config_` is JSON, not a queryable column). Stamped
-     * `CloseReason = 'Janitor'`, idempotent + concurrency-safe like the other sweeps. Returns the count closed.
+     * `'TimeLimit'`, or `'Idle'` when the row's idle moment passed before its deadline ({@link ExpiryCloseReason});
+     * idempotent + concurrency-safe like the other sweeps. Returns the count closed.
      */
     RunMaxDurationSweep(provider: IMetadataProvider, systemUser: UserInfo): Promise<number>;
     /**
@@ -235,8 +258,6 @@ export declare class SessionJanitor extends BaseSingleton<SessionJanitor> implem
      * window, which no sweep assembles any more. Never throws: a failure is logged and retried next pass.
      */
     private purgeExpiredLedgerShards;
-    /** Parses the absolute deadline (ms) from a session's `Config_` JSON, or null when absent/malformed. */
-    private parseSessionDeadlineMs;
     /** Register for graceful shutdown exactly once. */
     private ensureRegistered;
     /** Schedule the periodic sweep tick (close sweeps + recording recovery), exactly once. Timer is unref'd so it never blocks exit. */
@@ -295,7 +316,9 @@ export declare class SessionJanitor extends BaseSingleton<SessionJanitor> implem
     private recordRecoveryFailure;
     /**
      * Page through every session matching `filter` with keyset (`AfterKey`) pagination and close each
-     * via {@link SessionManager.CloseSession}, stamping `closeReason` on every row it transitions.
+     * via {@link SessionManager.CloseSession}, stamping the reason `reasonFor` returns for that row.
+     * A `null` reason skips the row (the SQL filter only narrows; `reasonFor` decides), and skipped rows
+     * are dropped before the channel batch load so it covers only rows that will close.
      * Returns the number successfully closed. A `Closed`-by-now row (raced by another instance) is a
      * harmless no-op that keeps its original reason.
      */

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

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

package/dist/agentSessions/SessionJanitor.js

@@ -3,6 +3,7 @@ import { CompositeKey, RunView, LogError, LogStatus, } from '@memberjunction/cor
 import { AssembleRealtimeRecordingFromLedger, RecoverRealtimeRecordingFromSegments, ResolveRecordingStorageAccountID, SqlRealtimeRecordingLedger, } from '@memberjunction/ai-agents';
 import { GetCurrentHostInstance, GetHostInstanceID } from './HostInstance.js';
 import { SessionManager } from './SessionManager.js';
+import { ExpiryCloseReason } from './sessionDeadline.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. */
@@ -113,6 +114,21 @@ class RecoveryBackoffTracker {
         }
     }
 }
+/**
+ * The close reason for a row the staleness sweep's SQL already judged stale (`LastActiveAt < cutoff`).
+ * {@link ExpiryCloseReason} returns null for such a row only when `LastActiveAt` will not parse (or the
+ * threshold is non-finite); skipping it would leave it `Active` forever, so it closes as `'Idle'` and the
+ * fallback is logged with the session ID.
+ */
+function staleRowCloseReason(session, nowMs, thresholdMs) {
+    const reason = ExpiryCloseReason(session, nowMs, thresholdMs);
+    if (reason !== null) {
+        return reason;
+    }
+    LogError(`[SessionJanitor] Staleness sweep: session ${session.ID} has LastActiveAt ${String(session.LastActiveAt)}; ` +
+        'LastActiveAt unparseable; closing as Idle');
+    return 'Idle';
+}
 /**
  * `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
@@ -130,9 +146,12 @@ class RecoveryBackoffTracker {
  *    `closeThresholdMinutes`, regardless of host. Catches sessions whose owner died without a clean
  *    reboot (OOM, scaled-down pod).
  * 3. **Max-duration sweep ({@link RunMaxDurationSweep})** — run on every periodic tick after the
- *    staleness sweep. Closes any session past its stored hard deadline (the public voice cost cap).
+ *    staleness sweep. Closes any session past its stored hard deadline (the public voice cost cap), and
+ *    any deadline-carrying session whose idle moment has passed; it stamps that row `'Idle'` when the idle
+ *    moment came before the deadline.
  *
- * The close sweeps stamp `CloseReason = 'Janitor'`. A shutdown-time path — {@link RunShutdownDrain},
+ * Startup recovery stamps `CloseReason = 'Janitor'`; the staleness and max-duration sweeps stamp `'Idle'` or
+ * `'TimeLimit'`, whichever expiry moment passed first ({@link ExpiryCloseReason}). A 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'`.
  *
@@ -230,6 +249,37 @@ export class SessionJanitor extends BaseSingleton {
         await this.RunStartupRecovery(provider, systemUser);
         this.scheduleSweep();
     }
+    /**
+     * Starts the janitor the way the host's `agentSessions.janitor` settings ask: applies the interval
+     * and close threshold, then {@link Start} when enabled, or {@link StartRecoveryOnly} when not.
+     * Throws (before doing any work) on an invalid interval or threshold; see {@link Configure}.
+     */
+    async StartWithSettings(settings, provider, systemUser) {
+        this.Configure({ sweepIntervalMs: settings.sweepIntervalMs, closeThresholdMinutes: settings.closeThresholdMinutes });
+        if (settings.enabled) {
+            await this.Start(provider, systemUser);
+        }
+        else {
+            await this.StartRecoveryOnly(provider, systemUser);
+        }
+    }
+    /**
+     * {@link Start} without the periodic tick, for hosts that turned the janitor off: run own-host
+     * startup recovery once and register for the graceful-shutdown drain, but schedule nothing, so an
+     * idle process issues no periodic queries. Stale-session, max-duration and recording-recovery
+     * sweeps then do not run in this process. Stops a tick an earlier {@link Start} scheduled.
+     */
+    async StartRecoveryOnly(provider, systemUser) {
+        this.Stop();
+        this._provider = provider;
+        this._systemUser = systemUser;
+        this.ensureRegistered();
+        await this.RunStartupRecovery(provider, systemUser);
+    }
+    /** Whether the periodic tick is currently scheduled (diagnostics and tests). */
+    get IsSweepScheduled() {
+        return this._sweepTimer !== null;
+    }
     /**
      * Stops the periodic tick and keeps any new recording recovery pass from starting until the next
      * {@link Start}, including one a tick already in progress would have started. A pass that is already
@@ -246,7 +296,7 @@ export class SessionJanitor extends BaseSingleton {
      * {@link IShutdownable}: stop 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, then wait
      * (at most {@link RECOVERY_SHUTDOWN_WAIT_MS}) for an in-flight recording recovery pass.
-     * Drained sessions are stamped `CloseReason = 'Shutdown'` (vs. `'Janitor'` for crash orphans),
+     * Drained sessions are stamped `CloseReason = 'Shutdown'` (vs. `'Janitor'` for crash orphans from an earlier boot),
      * 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).
      */
@@ -271,7 +321,7 @@ export class SessionJanitor extends BaseSingleton {
     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');
+        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`);
         }
@@ -294,8 +344,8 @@ export class SessionJanitor extends BaseSingleton {
             `AND HostInstanceID LIKE '${prefix}%' ` +
             `AND HostInstanceID <> '${current}'`;
         // The LIKE narrows the read; the exact check decides, since LIKE reads a `_` in a host name as any character.
-        const isPriorBoot = (session) => hostInstance.IsPriorBoot(session.HostInstanceID);
-        const closed = await this.sweepAndClose(filter, provider, systemUser, 'Janitor', isPriorBoot);
+        const reasonFor = (session) => hostInstance.IsPriorBoot(session.HostInstanceID) ? 'Janitor' : null;
+        const closed = await this.sweepAndClose(filter, provider, systemUser, reasonFor);
         if (closed > 0) {
             LogStatus(`[SessionJanitor] Startup recovery closed ${closed} orphaned session(s) from an earlier boot of this instance ` +
                 `(${hostInstance.GetInstancePrefix()})`);
@@ -304,12 +354,18 @@ export class SessionJanitor extends BaseSingleton {
     }
     /**
      * 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.
+     * close threshold, regardless of host. Stamped `'Idle'`, or `'TimeLimit'` when the row's authored deadline
+     * passed before its idle moment ({@link ExpiryCloseReason}). A row the SQL judged stale is never skipped:
+     * when its `LastActiveAt` will not parse it closes as `'Idle'` with a `LogError` ({@link staleRowCloseReason}).
+     * Idempotent and concurrency-safe. Returns the count closed.
      */
     async RunStalenessSweep(provider, systemUser) {
-        const cutoffIso = new Date(Date.now() - this._config.closeThresholdMinutes * 60_000).toISOString();
+        // One clock read feeds both the SQL cutoff and the per-row decision, so they cannot disagree.
+        const nowMs = Date.now();
+        const thresholdMs = this._config.closeThresholdMinutes * 60_000;
+        const cutoffIso = new Date(nowMs - thresholdMs).toISOString();
         const filter = `Status IN ('Active','Idle') AND LastActiveAt < '${cutoffIso}'`;
-        const closed = await this.sweepAndClose(filter, provider, systemUser, 'Janitor');
+        const closed = await this.sweepAndClose(filter, provider, systemUser, s => staleRowCloseReason(s, nowMs, thresholdMs));
         if (closed > 0) {
             LogStatus(`[SessionJanitor] Staleness sweep closed ${closed} stale session(s) (>${this._config.closeThresholdMinutes}m idle)`);
         }
@@ -323,20 +379,18 @@ export class SessionJanitor extends BaseSingleton {
      *
      * Only sessions that CARRY a deadline are loaded (a cheap `Config_ LIKE` pre-filter), then the exact
      * ISO deadline is parsed and compared in JS (`Config_` is JSON, not a queryable column). Stamped
-     * `CloseReason = 'Janitor'`, idempotent + concurrency-safe like the other sweeps. Returns the count closed.
+     * `'TimeLimit'`, or `'Idle'` when the row's idle moment passed before its deadline ({@link ExpiryCloseReason});
+     * idempotent + concurrency-safe like the other sweeps. Returns the count closed.
      */
     async RunMaxDurationSweep(provider, systemUser) {
         const nowMs = Date.now();
         // Only consider sessions that carry a deadline marker — keeps this sweep cheap (it never touches
         // the far-more-common uncapped sessions) while the JS check below enforces the exact deadline.
         const filter = `Status IN ('Active','Idle') AND Config LIKE '%maxSessionDeadlineIso%'`;
-        const isExpired = (session) => {
-            const deadlineMs = this.parseSessionDeadlineMs(session.Config_);
-            return deadlineMs != null && deadlineMs <= nowMs;
-        };
-        const closed = await this.sweepAndClose(filter, provider, systemUser, 'Janitor', isExpired);
+        const thresholdMs = this._config.closeThresholdMinutes * 60_000;
+        const closed = await this.sweepAndClose(filter, provider, systemUser, s => ExpiryCloseReason(s, nowMs, thresholdMs));
         if (closed > 0) {
-            LogStatus(`[SessionJanitor] Max-duration sweep closed ${closed} session(s) past their hard duration cap`);
+            LogStatus(`[SessionJanitor] Max-duration sweep closed ${closed} capped session(s) past their deadline or idle threshold`);
         }
         return closed;
     }
@@ -563,23 +617,6 @@ export class SessionJanitor extends BaseSingleton {
                 `${err instanceof Error ? err.message : String(err)}`);
         }
     }
-    /** Parses the absolute deadline (ms) from a session's `Config_` JSON, or null when absent/malformed. */
-    parseSessionDeadlineMs(configJson) {
-        if (!configJson) {
-            return null;
-        }
-        try {
-            const parsed = JSON.parse(configJson);
-            if (typeof parsed.maxSessionDeadlineIso !== 'string') {
-                return null;
-            }
-            const ms = Date.parse(parsed.maxSessionDeadlineIso);
-            return Number.isNaN(ms) ? null : ms;
-        }
-        catch {
-            return null;
-        }
-    }
     // ----- internals -------------------------------------------------------------------------
     /** Register for graceful shutdown exactly once. */
     ensureRegistered() {
@@ -830,24 +867,31 @@ export class SessionJanitor extends BaseSingleton {
     }
     /**
      * Page through every session matching `filter` with keyset (`AfterKey`) pagination and close each
-     * via {@link SessionManager.CloseSession}, stamping `closeReason` on every row it transitions.
+     * via {@link SessionManager.CloseSession}, stamping the reason `reasonFor` returns for that row.
+     * A `null` reason skips the row (the SQL filter only narrows; `reasonFor` decides), and skipped rows
+     * are dropped before the channel batch load so it covers only rows that will close.
      * 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, shouldClose) {
+    async sweepAndClose(filter, provider, systemUser, reasonFor) {
         let closedCount = 0;
         await this.forEachSessionPage(filter, provider, systemUser, async (fetched) => {
-            // Optional in-JS narrowing (e.g. exact deadline check the SQL pre-filter can't express).
-            const page = shouldClose ? fetched.filter(shouldClose) : fetched;
-            if (page.length === 0) {
+            const toClose = [];
+            for (const session of fetched) {
+                const reason = reasonFor(session);
+                if (reason !== null) {
+                    toClose.push({ session, reason });
+                }
+            }
+            if (toClose.length === 0) {
                 return;
             }
             // Batch-load every channel for this whole page of sessions in ONE query, then hand each
             // session its own slice to CloseSession — avoids the N+1 channel read (one RunView per
             // closing session) that tripped the sequential / multiple-same-entity telemetry.
-            const channelsBySession = await this.sessionManager.LoadActiveChannelsBySession(page.map(s => s.ID), systemUser, provider);
-            for (const session of page) {
-                const closed = await this.sessionManager.CloseSession(session.ID, systemUser, provider, closeReason, channelsBySession.get(session.ID.toLowerCase()) ?? []);
+            const channelsBySession = await this.sessionManager.LoadActiveChannelsBySession(toClose.map(c => c.session.ID), systemUser, provider);
+            for (const { session, reason } of toClose) {
+                const closed = await this.sessionManager.CloseSession(session.ID, systemUser, provider, reason, channelsBySession.get(session.ID.toLowerCase()) ?? []);
                 if (closed) {
                     closedCount++;
                 }