@iworkforces/tracelattice 2.0.8 → 2.1.1

package/dist/core/SessionErrors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionErrors.d.ts","sourceRoot":"","sources":["../../src/core/SessionErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAe,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEpE,iEAAiE;AACjE,MAAM,MAAM,2BAA2B,GACpC,WAAW,GACX,cAAc,GACd,UAAU,GACV,iBAAiB,GACjB,eAAe,GACf,SAAS,GACT,iBAAiB,CAAC;AAErB,mFAAmF;AACnF,qBAAa,2BAA4B,SAAQ,uBAAuB;IACvE,wFAAwF;IACxF,SAAgB,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjD,+CAA+C;IAC/C,SAAgB,KAAK,EAAE,2BAA2B,CAAC;gBAEhC,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,2BAA2B;CAUvF;AAED,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,uBAAuB;IAC5D,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM;CAMnD;AAED,8DAA8D;AAC9D,qBAAa,wBAAyB,SAAQ,uBAAuB;IACpE,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEpC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAU7E;AAED,gEAAgE;AAChE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,KAAK,CAAC;AAEhD,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEvD,gEAAgE;AAChE,qBAAa,uBAAwB,SAAQ,uBAAuB;IACnE,SAAgB,KAAK,EAAE,eAAe,CAAC;IACvC,SAAgB,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjD,SAAgB,MAAM,EAAE,gBAAgB,CAAC;gBAGxC,KAAK,EAAE,eAAe,EACtB,SAAS,CAAC,EAAE,SAAS,EACrB,MAAM,GAAE,gBAA+B;CAYxC"}
+{"version":3,"file":"SessionErrors.d.ts","sourceRoot":"","sources":["../../src/core/SessionErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAe,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEpE,iEAAiE;AACjE,MAAM,MAAM,2BAA2B,GACpC,WAAW,GACX,cAAc,GACd,UAAU,GACV,iBAAiB,GACjB,eAAe,GACf,SAAS,GACT,iBAAiB,CAAC;AAErB,mFAAmF;AACnF,qBAAa,2BAA4B,SAAQ,uBAAuB;IACvE,wFAAwF;IACxF,SAAgB,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjD,+CAA+C;IAC/C,SAAgB,KAAK,EAAE,2BAA2B,CAAC;gBAEhC,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,2BAA2B;CAUvF;AAED,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,uBAAuB;IAC5D,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM;CAMnD;AAED,8DAA8D;AAC9D,qBAAa,wBAAyB,SAAQ,uBAAuB;IACpE,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEpC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAU7E"}

package/dist/core/SessionErrors.js

@@ -32,19 +32,6 @@ class SessionAccessDeniedError extends SequentialThinkingError {
         this.actualOwner = actualOwner;
     }
 }
-class AsyncResetRequiredError extends SequentialThinkingError {
-    scope;
-    sessionId;
-    reason;
-    constructor(scope, sessionId, reason = 'persistent'){
-        const target = 'session' === scope ? `session '${sessionId}'` : 'all sessions';
-        super(`Synchronous clear cannot reset ${reason} ${target}; use the awaitable ${'session' === scope ? 'resetSession()' : 'resetAll()'} API`, ERROR_CODES.ASYNC_RESET_REQUIRED);
-        this.name = 'AsyncResetRequiredError';
-        this.scope = scope;
-        this.sessionId = sessionId;
-        this.reason = reason;
-    }
-}
-export { AsyncResetRequiredError, LockTimeoutError, SessionAccessDeniedError, SessionLifecycleClosedError };
+export { LockTimeoutError, SessionAccessDeniedError, SessionLifecycleClosedError };
 
 //# sourceMappingURL=SessionErrors.js.map

package/dist/core/SessionErrors.js.map

@@ -1 +1 @@
-{"version":3,"file":"core/SessionErrors.js","sources":["../../src/core/SessionErrors.ts"],"sourcesContent":["import type { SessionId } from '../contracts/ids.js';\nimport { ERROR_CODES, SequentialThinkingError } from '../errors.js';\n\n/** Lifecycle phase that can close ordinary session admission. */\nexport type SessionLifecycleClosedPhase =\n\t| 'resetting'\n\t| 'reset_failed'\n\t| 'evicting'\n\t| 'eviction_failed'\n\t| 'shutting_down'\n\t| 'stopped'\n\t| 'shutdown_failed';\n\n/** Error thrown when an operation arrives after lifecycle admission has closed. */\nexport class SessionLifecycleClosedError extends SequentialThinkingError {\n\t/** Session whose admission is closed, or `undefined` for a global exclusive request. */\n\tpublic readonly sessionId: SessionId | undefined;\n\t/** Lifecycle phase that rejected admission. */\n\tpublic readonly phase: SessionLifecycleClosedPhase;\n\n\tpublic constructor(sessionId: SessionId | undefined, phase: SessionLifecycleClosedPhase) {\n\t\tconst scope = sessionId === undefined ? 'Global' : `Session '${sessionId}'`;\n\t\tsuper(\n\t\t\t`${scope} lifecycle admission is closed in phase '${phase}'`,\n\t\t\tERROR_CODES.SESSION_LIFECYCLE_CLOSED\n\t\t);\n\t\tthis.name = 'SessionLifecycleClosedError';\n\t\tthis.sessionId = sessionId;\n\t\tthis.phase = phase;\n\t}\n}\n\n/** Error thrown when a per-session async lock cannot be acquired in time. */\nexport class LockTimeoutError extends SequentialThinkingError {\n\tpublic readonly sessionId: SessionId;\n\tpublic readonly timeoutMs: number;\n\n\tconstructor(sessionId: SessionId, timeoutMs: number) {\n\t\tsuper(`Lock timeout for session '${sessionId}' after ${timeoutMs}ms`, ERROR_CODES.LOCK_TIMEOUT);\n\t\tthis.name = 'LockTimeoutError';\n\t\tthis.sessionId = sessionId;\n\t\tthis.timeoutMs = timeoutMs;\n\t}\n}\n\n/** Error thrown when a session is accessed by a non-owner. */\nexport class SessionAccessDeniedError extends SequentialThinkingError {\n\tpublic readonly sessionId: SessionId;\n\tpublic readonly expectedOwner: string;\n\tpublic readonly actualOwner: string | undefined;\n\n\tconstructor(sessionId: SessionId, expectedOwner: string, actualOwner?: string) {\n\t\tsuper(\n\t\t\t`Access denied to session '${sessionId}': owned by '${expectedOwner}', accessed by '${actualOwner ?? 'anonymous'}'`,\n\t\t\tERROR_CODES.SESSION_ACCESS_DENIED\n\t\t);\n\t\tthis.name = 'SessionAccessDeniedError';\n\t\tthis.sessionId = sessionId;\n\t\tthis.expectedOwner = expectedOwner;\n\t\tthis.actualOwner = actualOwner;\n\t}\n}\n\n/** Scope requested through the legacy synchronous clear API. */\nexport type AsyncResetScope = 'session' | 'all';\n\n/** Condition that makes the legacy synchronous clear API unsafe. */\nexport type AsyncResetReason = 'persistent' | 'active';\n\n/** Error raised when state requires the awaitable reset API. */\nexport class AsyncResetRequiredError extends SequentialThinkingError {\n\tpublic readonly scope: AsyncResetScope;\n\tpublic readonly sessionId: SessionId | undefined;\n\tpublic readonly reason: AsyncResetReason;\n\n\tconstructor(\n\t\tscope: AsyncResetScope,\n\t\tsessionId?: SessionId,\n\t\treason: AsyncResetReason = 'persistent'\n\t) {\n\t\tconst target = scope === 'session' ? `session '${sessionId}'` : 'all sessions';\n\t\tsuper(\n\t\t\t`Synchronous clear cannot reset ${reason} ${target}; use the awaitable ${scope === 'session' ? 'resetSession()' : 'resetAll()'} API`,\n\t\t\tERROR_CODES.ASYNC_RESET_REQUIRED\n\t\t);\n\t\tthis.name = 'AsyncResetRequiredError';\n\t\tthis.scope = scope;\n\t\tthis.sessionId = sessionId;\n\t\tthis.reason = reason;\n\t}\n}\n"],"names":["SessionLifecycleClosedError","SequentialThinkingError","sessionId","phase","scope","undefined","ERROR_CODES","LockTimeoutError","timeoutMs","SessionAccessDeniedError","expectedOwner","actualOwner","AsyncResetRequiredError","reason","target"],"mappings":";AAcO,MAAMA,oCAAoCC;IAEhC,UAAiC;IAEjC,MAAmC;IAEnD,YAAmBC,SAAgC,EAAEC,KAAkC,CAAE;QACxF,MAAMC,QAAQF,AAAcG,WAAdH,YAA0B,WAAW,CAAC,SAAS,EAAEA,UAAU,CAAC,CAAC;QAC3E,KAAK,CACJ,GAAGE,MAAM,yCAAyC,EAAED,MAAM,CAAC,CAAC,EAC5DG,YAAY,wBAAwB;QAErC,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,SAAS,GAAGJ;QACjB,IAAI,CAAC,KAAK,GAAGC;IACd;AACD;AAGO,MAAMI,yBAAyBN;IACrB,UAAqB;IACrB,UAAkB;IAElC,YAAYC,SAAoB,EAAEM,SAAiB,CAAE;QACpD,KAAK,CAAC,CAAC,0BAA0B,EAAEN,UAAU,QAAQ,EAAEM,UAAU,EAAE,CAAC,EAAEF,YAAY,YAAY;QAC9F,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,SAAS,GAAGJ;QACjB,IAAI,CAAC,SAAS,GAAGM;IAClB;AACD;AAGO,MAAMC,iCAAiCR;IAC7B,UAAqB;IACrB,cAAsB;IACtB,YAAgC;IAEhD,YAAYC,SAAoB,EAAEQ,aAAqB,EAAEC,WAAoB,CAAE;QAC9E,KAAK,CACJ,CAAC,0BAA0B,EAAET,UAAU,aAAa,EAAEQ,cAAc,gBAAgB,EAAEC,eAAe,YAAY,CAAC,CAAC,EACnHL,YAAY,qBAAqB;QAElC,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,SAAS,GAAGJ;QACjB,IAAI,CAAC,aAAa,GAAGQ;QACrB,IAAI,CAAC,WAAW,GAAGC;IACpB;AACD;AASO,MAAMC,gCAAgCX;IAC5B,MAAuB;IACvB,UAAiC;IACjC,OAAyB;IAEzC,YACCG,KAAsB,EACtBF,SAAqB,EACrBW,SAA2B,YAAY,CACtC;QACD,MAAMC,SAASV,AAAU,cAAVA,QAAsB,CAAC,SAAS,EAAEF,UAAU,CAAC,CAAC,GAAG;QAChE,KAAK,CACJ,CAAC,+BAA+B,EAAEW,OAAO,CAAC,EAAEC,OAAO,oBAAoB,EAAEV,AAAU,cAAVA,QAAsB,mBAAmB,aAAa,IAAI,CAAC,EACpIE,YAAY,oBAAoB;QAEjC,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,KAAK,GAAGF;QACb,IAAI,CAAC,SAAS,GAAGF;QACjB,IAAI,CAAC,MAAM,GAAGW;IACf;AACD"}
+{"version":3,"file":"core/SessionErrors.js","sources":["../../src/core/SessionErrors.ts"],"sourcesContent":["import type { SessionId } from '../contracts/ids.js';\nimport { ERROR_CODES, SequentialThinkingError } from '../errors.js';\n\n/** Lifecycle phase that can close ordinary session admission. */\nexport type SessionLifecycleClosedPhase =\n\t| 'resetting'\n\t| 'reset_failed'\n\t| 'evicting'\n\t| 'eviction_failed'\n\t| 'shutting_down'\n\t| 'stopped'\n\t| 'shutdown_failed';\n\n/** Error thrown when an operation arrives after lifecycle admission has closed. */\nexport class SessionLifecycleClosedError extends SequentialThinkingError {\n\t/** Session whose admission is closed, or `undefined` for a global exclusive request. */\n\tpublic readonly sessionId: SessionId | undefined;\n\t/** Lifecycle phase that rejected admission. */\n\tpublic readonly phase: SessionLifecycleClosedPhase;\n\n\tpublic constructor(sessionId: SessionId | undefined, phase: SessionLifecycleClosedPhase) {\n\t\tconst scope = sessionId === undefined ? 'Global' : `Session '${sessionId}'`;\n\t\tsuper(\n\t\t\t`${scope} lifecycle admission is closed in phase '${phase}'`,\n\t\t\tERROR_CODES.SESSION_LIFECYCLE_CLOSED\n\t\t);\n\t\tthis.name = 'SessionLifecycleClosedError';\n\t\tthis.sessionId = sessionId;\n\t\tthis.phase = phase;\n\t}\n}\n\n/** Error thrown when a per-session async lock cannot be acquired in time. */\nexport class LockTimeoutError extends SequentialThinkingError {\n\tpublic readonly sessionId: SessionId;\n\tpublic readonly timeoutMs: number;\n\n\tconstructor(sessionId: SessionId, timeoutMs: number) {\n\t\tsuper(`Lock timeout for session '${sessionId}' after ${timeoutMs}ms`, ERROR_CODES.LOCK_TIMEOUT);\n\t\tthis.name = 'LockTimeoutError';\n\t\tthis.sessionId = sessionId;\n\t\tthis.timeoutMs = timeoutMs;\n\t}\n}\n\n/** Error thrown when a session is accessed by a non-owner. */\nexport class SessionAccessDeniedError extends SequentialThinkingError {\n\tpublic readonly sessionId: SessionId;\n\tpublic readonly expectedOwner: string;\n\tpublic readonly actualOwner: string | undefined;\n\n\tconstructor(sessionId: SessionId, expectedOwner: string, actualOwner?: string) {\n\t\tsuper(\n\t\t\t`Access denied to session '${sessionId}': owned by '${expectedOwner}', accessed by '${actualOwner ?? 'anonymous'}'`,\n\t\t\tERROR_CODES.SESSION_ACCESS_DENIED\n\t\t);\n\t\tthis.name = 'SessionAccessDeniedError';\n\t\tthis.sessionId = sessionId;\n\t\tthis.expectedOwner = expectedOwner;\n\t\tthis.actualOwner = actualOwner;\n\t}\n}\n"],"names":["SessionLifecycleClosedError","SequentialThinkingError","sessionId","phase","scope","undefined","ERROR_CODES","LockTimeoutError","timeoutMs","SessionAccessDeniedError","expectedOwner","actualOwner"],"mappings":";AAcO,MAAMA,oCAAoCC;IAEhC,UAAiC;IAEjC,MAAmC;IAEnD,YAAmBC,SAAgC,EAAEC,KAAkC,CAAE;QACxF,MAAMC,QAAQF,AAAcG,WAAdH,YAA0B,WAAW,CAAC,SAAS,EAAEA,UAAU,CAAC,CAAC;QAC3E,KAAK,CACJ,GAAGE,MAAM,yCAAyC,EAAED,MAAM,CAAC,CAAC,EAC5DG,YAAY,wBAAwB;QAErC,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,SAAS,GAAGJ;QACjB,IAAI,CAAC,KAAK,GAAGC;IACd;AACD;AAGO,MAAMI,yBAAyBN;IACrB,UAAqB;IACrB,UAAkB;IAElC,YAAYC,SAAoB,EAAEM,SAAiB,CAAE;QACpD,KAAK,CAAC,CAAC,0BAA0B,EAAEN,UAAU,QAAQ,EAAEM,UAAU,EAAE,CAAC,EAAEF,YAAY,YAAY;QAC9F,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,SAAS,GAAGJ;QACjB,IAAI,CAAC,SAAS,GAAGM;IAClB;AACD;AAGO,MAAMC,iCAAiCR;IAC7B,UAAqB;IACrB,cAAsB;IACtB,YAAgC;IAEhD,YAAYC,SAAoB,EAAEQ,aAAqB,EAAEC,WAAoB,CAAE;QAC9E,KAAK,CACJ,CAAC,0BAA0B,EAAET,UAAU,aAAa,EAAEQ,cAAc,gBAAgB,EAAEC,eAAe,YAAY,CAAC,CAAC,EACnHL,YAAY,qBAAqB;QAElC,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,SAAS,GAAGJ;QACjB,IAAI,CAAC,aAAa,GAAGQ;QACrB,IAAI,CAAC,WAAW,GAAGC;IACpB;AACD"}

package/dist/core/SessionLock.d.ts

@@ -6,8 +6,7 @@
  * (when no waiters chained on top), preventing unbounded memory growth.
  *
  * Different sessions are fully independent: locks for distinct session
- * ids never block each other. `undefined`/empty session ids share a
- * single global slot.
+ * ids never block each other.
  *
  * @module session-lock
  */
@@ -41,7 +40,7 @@ export declare class SessionLock implements ISessionLock {
      */
     get size(): number;
     /** Returns whether a session currently has a holder or queued operation. */
-    isActive(sessionId: SessionId | undefined): boolean;
+    isActive(sessionId: SessionId): boolean;
     /**
      * Execute `fn` while holding the lock for the given session.
      *
@@ -49,11 +48,11 @@ export declare class SessionLock implements ISessionLock {
      * different sessions run in parallel. The lock is always released
      * (via `finally`) even if `fn` throws.
      *
-     * @param sessionId - Session to lock. Falsy values share a global slot.
+     * @param sessionId - Session to lock.
      * @param fn - Critical section to run while holding the lock.
      * @param timeoutMs - Maximum time to wait for the lock (default 5000ms).
      * @throws {LockTimeoutError} When the lock cannot be acquired within `timeoutMs`.
      */
-    withLock<T>(sessionId: SessionId | undefined, fn: () => Promise<T>, timeoutMs?: number): Promise<T>;
+    withLock<T>(sessionId: SessionId, fn: () => Promise<T>, timeoutMs?: number): Promise<T>;
 }
 //# sourceMappingURL=SessionLock.d.ts.map

package/dist/core/SessionLock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionLock.d.ts","sourceRoot":"","sources":["../../src/core/SessionLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAgBrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAE9D;;;OAGG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,4EAA4E;IACrE,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO;IAI1D;;;;;;;;;;;OAWG;IACU,QAAQ,CAAC,CAAC,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,GAAE,MAAgC,GACzC,OAAO,CAAC,CAAC,CAAC;CAqCb"}
+{"version":3,"file":"SessionLock.d.ts","sourceRoot":"","sources":["../../src/core/SessionLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAE9D;;;OAGG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,4EAA4E;IACrE,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAI9C;;;;;;;;;;;OAWG;IACU,QAAQ,CAAC,CAAC,EACtB,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,GAAE,MAAgC,GACzC,OAAO,CAAC,CAAC,CAAC;CAoCb"}

package/dist/core/SessionLock.js

@@ -1,30 +1,25 @@
-import { GLOBAL_SESSION_ID } from "../contracts/ids.js";
 import { LockTimeoutError } from "./SessionErrors.js";
 const DEFAULT_LOCK_TIMEOUT_MS = 5000;
-function lockKey(sessionId) {
-    return sessionId && sessionId.length > 0 ? sessionId : GLOBAL_SESSION_ID;
-}
 class SessionLock {
     _locks = new Map();
     get size() {
         return this._locks.size;
     }
     isActive(sessionId) {
-        return this._locks.has(lockKey(sessionId));
+        return this._locks.has(sessionId);
     }
     async withLock(sessionId, fn, timeoutMs = DEFAULT_LOCK_TIMEOUT_MS) {
-        const key = lockKey(sessionId);
-        const previous = this._locks.get(key) ?? Promise.resolve();
+        const previous = this._locks.get(sessionId) ?? Promise.resolve();
         const release = Promise.withResolvers();
         const next = previous.then(()=>release.promise, ()=>release.promise);
-        this._locks.set(key, next);
+        this._locks.set(sessionId, next);
         next.then(()=>{
-            if (this._locks.get(key) === next) this._locks.delete(key);
+            if (this._locks.get(sessionId) === next) this._locks.delete(sessionId);
         });
         let timeoutId;
         try {
             await new Promise((resolve, reject)=>{
-                timeoutId = setTimeout(()=>reject(new LockTimeoutError(key, timeoutMs)), timeoutMs);
+                timeoutId = setTimeout(()=>reject(new LockTimeoutError(sessionId, timeoutMs)), timeoutMs);
                 previous.then(()=>resolve(), ()=>resolve());
             });
             return await fn();

package/dist/core/SessionLock.js.map

@@ -1 +1 @@
-{"version":3,"file":"core/SessionLock.js","sources":["../../src/core/SessionLock.ts"],"sourcesContent":["/**\n * Per-session async lock to prevent concurrent state mutations.\n *\n * Uses chained promises: each lock acquisition waits for the previous\n * holder's promise to resolve. The lock map entry is purged after release\n * (when no waiters chained on top), preventing unbounded memory growth.\n *\n * Different sessions are fully independent: locks for distinct session\n * ids never block each other. `undefined`/empty session ids share a\n * single global slot.\n *\n * @module session-lock\n */\n\nimport type { ISessionLock } from '../contracts/interfaces.js';\nimport type { SessionId } from '../contracts/ids.js';\nimport { GLOBAL_SESSION_ID } from '../contracts/ids.js';\nimport { LockTimeoutError } from './SessionErrors.js';\n\nconst DEFAULT_LOCK_TIMEOUT_MS = 5000;\n\n/**\n * Normalize a session id for keying the internal lock map.\n * Treats `undefined`, `null`, and empty strings as the global session.\n *\n * @internal\n */\nfunction lockKey(sessionId: SessionId | undefined): SessionId {\n\treturn sessionId && sessionId.length > 0 ? sessionId : GLOBAL_SESSION_ID;\n}\n\n/**\n * In-memory implementation of {@link ISessionLock}.\n *\n * Maintains a `Map<string, Promise<void>>` where each value is the tail\n * of the lock chain for that session. New acquisitions chain onto the\n * tail and replace it; once they release, the entry is purged unless a\n * later acquisition chained on top.\n *\n * Lock chain integrity is preserved across timeouts and `fn` errors: a\n * waiter's slot is only released after the previous holder actually\n * finishes, even if the waiter aborted via {@link LockTimeoutError}.\n *\n * @example\n * ```typescript\n * const lock = new SessionLock();\n * await lock.withLock('session-a', async () => {\n *   // critical section — concurrent calls for 'session-a' wait\n * });\n * ```\n */\nexport class SessionLock implements ISessionLock {\n\tprivate readonly _locks = new Map<SessionId, Promise<void>>();\n\n\t/**\n\t * Number of currently held lock chains. Useful for diagnostics\n\t * and leak assertions in tests.\n\t */\n\tpublic get size(): number {\n\t\treturn this._locks.size;\n\t}\n\n\t/** Returns whether a session currently has a holder or queued operation. */\n\tpublic isActive(sessionId: SessionId | undefined): boolean {\n\t\treturn this._locks.has(lockKey(sessionId));\n\t}\n\n\t/**\n\t * Execute `fn` while holding the lock for the given session.\n\t *\n\t * Concurrent calls for the same session are serialized. Calls for\n\t * different sessions run in parallel. The lock is always released\n\t * (via `finally`) even if `fn` throws.\n\t *\n\t * @param sessionId - Session to lock. Falsy values share a global slot.\n\t * @param fn - Critical section to run while holding the lock.\n\t * @param timeoutMs - Maximum time to wait for the lock (default 5000ms).\n\t * @throws {LockTimeoutError} When the lock cannot be acquired within `timeoutMs`.\n\t */\n\tpublic async withLock<T>(\n\t\tsessionId: SessionId | undefined,\n\t\tfn: () => Promise<T>,\n\t\ttimeoutMs: number = DEFAULT_LOCK_TIMEOUT_MS\n\t): Promise<T> {\n\t\tconst key = lockKey(sessionId);\n\t\tconst previous = this._locks.get(key) ?? Promise.resolve();\n\n\t\t// `next` is the tail this acquirer publishes to the chain. It only\n\t\t// resolves after `previous` settles, guaranteeing serialization even\n\t\t// when the current acquirer times out before holding the lock.\n\t\tconst release = Promise.withResolvers<void>();\n\t\tconst next = previous.then(\n\t\t\t() => release.promise,\n\t\t\t() => release.promise\n\t\t);\n\t\tthis._locks.set(key, next);\n\t\t// Identity protects a later acquisition from an earlier tail's cleanup.\n\t\tvoid next.then(() => {\n\t\t\tif (this._locks.get(key) === next) {\n\t\t\t\tthis._locks.delete(key);\n\t\t\t}\n\t\t});\n\n\t\tlet timeoutId: ReturnType<typeof setTimeout> | undefined;\n\t\ttry {\n\t\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\t\ttimeoutId = setTimeout(() => reject(new LockTimeoutError(key, timeoutMs)), timeoutMs);\n\t\t\t\tprevious.then(\n\t\t\t\t\t() => resolve(),\n\t\t\t\t\t() => resolve() // previous holder's failure must not poison the chain\n\t\t\t\t);\n\t\t\t});\n\t\t\treturn await fn();\n\t\t} finally {\n\t\t\tif (timeoutId !== undefined) {\n\t\t\t\tclearTimeout(timeoutId);\n\t\t\t}\n\t\t\trelease.resolve();\n\t\t}\n\t}\n}\n"],"names":["DEFAULT_LOCK_TIMEOUT_MS","lockKey","sessionId","GLOBAL_SESSION_ID","SessionLock","Map","fn","timeoutMs","key","previous","Promise","release","next","timeoutId","resolve","reject","setTimeout","LockTimeoutError","undefined","clearTimeout"],"mappings":";;AAmBA,MAAMA,0BAA0B;AAQhC,SAASC,QAAQC,SAAgC;IAChD,OAAOA,aAAaA,UAAU,MAAM,GAAG,IAAIA,YAAYC;AACxD;AAsBO,MAAMC;IACK,SAAS,IAAIC,MAAgC;IAM9D,IAAW,OAAe;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI;IACxB;IAGO,SAASH,SAAgC,EAAW;QAC1D,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAACD,QAAQC;IAChC;IAcA,MAAa,SACZA,SAAgC,EAChCI,EAAoB,EACpBC,YAAoBP,uBAAuB,EAC9B;QACb,MAAMQ,MAAMP,QAAQC;QACpB,MAAMO,WAAW,IAAI,CAAC,MAAM,CAAC,GAAG,CAACD,QAAQE,QAAQ,OAAO;QAKxD,MAAMC,UAAUD,QAAQ,aAAa;QACrC,MAAME,OAAOH,SAAS,IAAI,CACzB,IAAME,QAAQ,OAAO,EACrB,IAAMA,QAAQ,OAAO;QAEtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAACH,KAAKI;QAEhBA,KAAK,IAAI,CAAC;YACd,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAACJ,SAASI,MAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,CAACJ;QAErB;QAEA,IAAIK;QACJ,IAAI;YACH,MAAM,IAAIH,QAAc,CAACI,SAASC;gBACjCF,YAAYG,WAAW,IAAMD,OAAO,IAAIE,iBAAiBT,KAAKD,aAAaA;gBAC3EE,SAAS,IAAI,CACZ,IAAMK,WACN,IAAMA;YAER;YACA,OAAO,MAAMR;QACd,SAAU;YACT,IAAIO,AAAcK,WAAdL,WACHM,aAAaN;YAEdF,QAAQ,OAAO;QAChB;IACD;AACD"}
+{"version":3,"file":"core/SessionLock.js","sources":["../../src/core/SessionLock.ts"],"sourcesContent":["/**\n * Per-session async lock to prevent concurrent state mutations.\n *\n * Uses chained promises: each lock acquisition waits for the previous\n * holder's promise to resolve. The lock map entry is purged after release\n * (when no waiters chained on top), preventing unbounded memory growth.\n *\n * Different sessions are fully independent: locks for distinct session\n * ids never block each other.\n *\n * @module session-lock\n */\n\nimport type { ISessionLock } from '../contracts/interfaces.js';\nimport type { SessionId } from '../contracts/ids.js';\nimport { LockTimeoutError } from './SessionErrors.js';\n\nconst DEFAULT_LOCK_TIMEOUT_MS = 5000;\n\n/**\n * In-memory implementation of {@link ISessionLock}.\n *\n * Maintains a `Map<string, Promise<void>>` where each value is the tail\n * of the lock chain for that session. New acquisitions chain onto the\n * tail and replace it; once they release, the entry is purged unless a\n * later acquisition chained on top.\n *\n * Lock chain integrity is preserved across timeouts and `fn` errors: a\n * waiter's slot is only released after the previous holder actually\n * finishes, even if the waiter aborted via {@link LockTimeoutError}.\n *\n * @example\n * ```typescript\n * const lock = new SessionLock();\n * await lock.withLock('session-a', async () => {\n *   // critical section — concurrent calls for 'session-a' wait\n * });\n * ```\n */\nexport class SessionLock implements ISessionLock {\n\tprivate readonly _locks = new Map<SessionId, Promise<void>>();\n\n\t/**\n\t * Number of currently held lock chains. Useful for diagnostics\n\t * and leak assertions in tests.\n\t */\n\tpublic get size(): number {\n\t\treturn this._locks.size;\n\t}\n\n\t/** Returns whether a session currently has a holder or queued operation. */\n\tpublic isActive(sessionId: SessionId): boolean {\n\t\treturn this._locks.has(sessionId);\n\t}\n\n\t/**\n\t * Execute `fn` while holding the lock for the given session.\n\t *\n\t * Concurrent calls for the same session are serialized. Calls for\n\t * different sessions run in parallel. The lock is always released\n\t * (via `finally`) even if `fn` throws.\n\t *\n\t * @param sessionId - Session to lock.\n\t * @param fn - Critical section to run while holding the lock.\n\t * @param timeoutMs - Maximum time to wait for the lock (default 5000ms).\n\t * @throws {LockTimeoutError} When the lock cannot be acquired within `timeoutMs`.\n\t */\n\tpublic async withLock<T>(\n\t\tsessionId: SessionId,\n\t\tfn: () => Promise<T>,\n\t\ttimeoutMs: number = DEFAULT_LOCK_TIMEOUT_MS\n\t): Promise<T> {\n\t\tconst previous = this._locks.get(sessionId) ?? Promise.resolve();\n\n\t\t// `next` is the tail this acquirer publishes to the chain. It only\n\t\t// resolves after `previous` settles, guaranteeing serialization even\n\t\t// when the current acquirer times out before holding the lock.\n\t\tconst release = Promise.withResolvers<void>();\n\t\tconst next = previous.then(\n\t\t\t() => release.promise,\n\t\t\t() => release.promise\n\t\t);\n\t\tthis._locks.set(sessionId, next);\n\t\t// Identity protects a later acquisition from an earlier tail's cleanup.\n\t\tvoid next.then(() => {\n\t\t\tif (this._locks.get(sessionId) === next) {\n\t\t\t\tthis._locks.delete(sessionId);\n\t\t\t}\n\t\t});\n\n\t\tlet timeoutId: ReturnType<typeof setTimeout> | undefined;\n\t\ttry {\n\t\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\t\ttimeoutId = setTimeout(() => reject(new LockTimeoutError(sessionId, timeoutMs)), timeoutMs);\n\t\t\t\tprevious.then(\n\t\t\t\t\t() => resolve(),\n\t\t\t\t\t() => resolve() // previous holder's failure must not poison the chain\n\t\t\t\t);\n\t\t\t});\n\t\t\treturn await fn();\n\t\t} finally {\n\t\t\tif (timeoutId !== undefined) {\n\t\t\t\tclearTimeout(timeoutId);\n\t\t\t}\n\t\t\trelease.resolve();\n\t\t}\n\t}\n}\n"],"names":["DEFAULT_LOCK_TIMEOUT_MS","SessionLock","Map","sessionId","fn","timeoutMs","previous","Promise","release","next","timeoutId","resolve","reject","setTimeout","LockTimeoutError","undefined","clearTimeout"],"mappings":";AAiBA,MAAMA,0BAA0B;AAsBzB,MAAMC;IACK,SAAS,IAAIC,MAAgC;IAM9D,IAAW,OAAe;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI;IACxB;IAGO,SAASC,SAAoB,EAAW;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAACA;IACxB;IAcA,MAAa,SACZA,SAAoB,EACpBC,EAAoB,EACpBC,YAAoBL,uBAAuB,EAC9B;QACb,MAAMM,WAAW,IAAI,CAAC,MAAM,CAAC,GAAG,CAACH,cAAcI,QAAQ,OAAO;QAK9D,MAAMC,UAAUD,QAAQ,aAAa;QACrC,MAAME,OAAOH,SAAS,IAAI,CACzB,IAAME,QAAQ,OAAO,EACrB,IAAMA,QAAQ,OAAO;QAEtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAACL,WAAWM;QAEtBA,KAAK,IAAI,CAAC;YACd,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAACN,eAAeM,MAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAACN;QAErB;QAEA,IAAIO;QACJ,IAAI;YACH,MAAM,IAAIH,QAAc,CAACI,SAASC;gBACjCF,YAAYG,WAAW,IAAMD,OAAO,IAAIE,iBAAiBX,WAAWE,aAAaA;gBACjFC,SAAS,IAAI,CACZ,IAAMK,WACN,IAAMA;YAER;YACA,OAAO,MAAMP;QACd,SAAU;YACT,IAAIM,AAAcK,WAAdL,WACHM,aAAaN;YAEdF,QAAQ,OAAO;QAChB;IACD;AACD"}

package/dist/core/SessionManager.d.ts

@@ -15,7 +15,6 @@ export interface SessionLike {
 export type SessionEligibility<S extends SessionLike> = (sessionId: SessionId, session: S) => boolean;
 /** Configuration options for {@link SessionManager}. */
 export interface SessionManagerConfig {
-    readonly defaultSessionId: SessionId;
     readonly sessionTtlMs: number;
     readonly cleanupIntervalMs: number;
     readonly getMaxSessions: () => number;
@@ -31,7 +30,6 @@ export interface SessionManagerConfig {
  * ```
  */
 export declare class SessionManager<S extends SessionLike> {
-    private readonly _defaultSessionId;
     private readonly _sessionTtlMs;
     private readonly _cleanupIntervalMs;
     private readonly _getMaxSessions;

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

@@ -1 +1 @@
-{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/core/SessionManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CACjC;AAED,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI,CACvD,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,CAAC,KACN,OAAO,CAAC;AAEb,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD;;;;;;;GAOG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,aAAa,CAA+C;gBAEjD,MAAM,EAAE,oBAAoB;IAS/C,wDAAwD;IACxD,IAAW,KAAK,IAAI,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAExD;IAED;;OAEG;IACI,iBAAiB,CACvB,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,EAC3B,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACjC,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1D,IAAI;IAgBP,wCAAwC;IACjC,gBAAgB,IAAI,IAAI;IAM/B;;;;;;OAMG;IACI,wBAAwB,CAC9B,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,EACnC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC/B,SAAS,SAAS,EAAE,GAAG,SAAS;IAiCnC,mFAAmF;IAC5E,sBAAsB,CAC5B,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,EACnC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACjC,GAAG,GAAE,MAAmB,GACtB,SAAS,SAAS,EAAE;IAWvB,OAAO,CAAC,sBAAsB;CAe9B"}
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/core/SessionManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CACjC;AAED,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI,CACvD,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,CAAC,KACN,OAAO,CAAC;AAEb,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD;;;;;;;GAOG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,aAAa,CAA+C;gBAEjD,MAAM,EAAE,oBAAoB;IAQ/C,wDAAwD;IACxD,IAAW,KAAK,IAAI,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAExD;IAED;;OAEG;IACI,iBAAiB,CACvB,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,EAC3B,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACjC,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1D,IAAI;IAgBP,wCAAwC;IACjC,gBAAgB,IAAI,IAAI;IAM/B;;;;;;OAMG;IACI,wBAAwB,CAC9B,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,EACnC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC/B,SAAS,SAAS,EAAE,GAAG,SAAS;IA8BnC,mFAAmF;IAC5E,sBAAsB,CAC5B,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,EACnC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACjC,GAAG,GAAE,MAAmB,GACtB,SAAS,SAAS,EAAE;IAUvB,OAAO,CAAC,sBAAsB;CAe9B"}

package/dist/core/SessionManager.js

@@ -1,6 +1,5 @@
 import { NullLogger } from "../logger/NullLogger.js";
 class SessionManager {
-    _defaultSessionId;
     _sessionTtlMs;
     _cleanupIntervalMs;
     _getMaxSessions;
@@ -8,7 +7,6 @@ class SessionManager {
     _logger;
     _cleanupTimer = null;
     constructor(config){
-        this._defaultSessionId = config.defaultSessionId;
         this._sessionTtlMs = config.sessionTtlMs;
         this._cleanupIntervalMs = config.cleanupIntervalMs;
         this._getMaxSessions = config.getMaxSessions;
@@ -42,19 +40,19 @@ class SessionManager {
         if (void 0 !== owner) {
             const ownerCount = live.filter((candidate)=>candidate.session.owner === owner).length;
             const ownerNeed = Math.max(0, ownerCount + 1 - this._maxSessionsPerOwner);
-            selected.push(...live.filter((candidate)=>candidate.session.owner === owner && candidate.sessionId !== this._defaultSessionId && isEligible(candidate.sessionId, candidate.session)).slice(0, ownerNeed));
+            selected.push(...live.filter((candidate)=>candidate.session.owner === owner && isEligible(candidate.sessionId, candidate.session)).slice(0, ownerNeed));
             if (selected.length < ownerNeed) return;
         }
         const globalNeed = Math.max(0, live.length + 1 - this._getMaxSessions());
         const remainingNeed = Math.max(0, globalNeed - selected.length);
         const selectedIds = new Set(selected.map((candidate)=>candidate.sessionId));
-        const alternatives = live.filter((candidate)=>candidate.sessionId !== this._defaultSessionId && !selectedIds.has(candidate.sessionId) && isEligible(candidate.sessionId, candidate.session));
+        const alternatives = live.filter((candidate)=>!selectedIds.has(candidate.sessionId) && isEligible(candidate.sessionId, candidate.session));
         if (alternatives.length < remainingNeed) return;
         selected.push(...alternatives.slice(0, remainingNeed));
         return selected.map((candidate)=>candidate.sessionId);
     }
     staleSessionCandidates(sessions, isEligible, now = Date.now()) {
-        return this._orderedLiveCandidates(sessions).filter((candidate)=>candidate.sessionId !== this._defaultSessionId && now - candidate.session.lastAccessedAt > this._sessionTtlMs && isEligible(candidate.sessionId, candidate.session)).map((candidate)=>candidate.sessionId);
+        return this._orderedLiveCandidates(sessions).filter((candidate)=>now - candidate.session.lastAccessedAt > this._sessionTtlMs && isEligible(candidate.sessionId, candidate.session)).map((candidate)=>candidate.sessionId);
     }
     _orderedLiveCandidates(sessions) {
         const candidates = [];

package/dist/core/SessionManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"core/SessionManager.js","sources":["../../src/core/SessionManager.ts"],"sourcesContent":["/**\n * Deterministic session cleanup candidate policy and periodic timer.\n *\n * @module SessionManager\n */\n\nimport type { SessionId } from '../contracts/ids.js';\nimport { NullLogger } from '../logger/NullLogger.js';\nimport type { Logger } from '../logger/StructuredLogger.js';\n\n/** Minimal session facts needed by capacity and TTL policy. */\nexport interface SessionLike {\n\treadonly lastAccessedAt: number;\n\treadonly owner?: string;\n\treadonly provenance?: 'restored';\n}\n\n/** Determines whether a candidate can be removed at this instant. */\nexport type SessionEligibility<S extends SessionLike> = (\n\tsessionId: SessionId,\n\tsession: S\n) => boolean;\n\n/** Configuration options for {@link SessionManager}. */\nexport interface SessionManagerConfig {\n\treadonly defaultSessionId: SessionId;\n\treadonly sessionTtlMs: number;\n\treadonly cleanupIntervalMs: number;\n\treadonly getMaxSessions: () => number;\n\treadonly maxSessionsPerOwner?: number;\n\treadonly logger?: Logger;\n}\n\ntype Candidate<S extends SessionLike> = {\n\treadonly sessionId: SessionId;\n\treadonly session: S;\n\treadonly insertionOrder: number;\n};\n\n/**\n * Produces complete candidate sets but never mutates the caller-owned session map.\n *\n * @example\n * ```ts\n * const victims = manager.planProspectiveAdmission(sessions, owner, lifecycle.isIdle);\n * ```\n */\nexport class SessionManager<S extends SessionLike> {\n\tprivate readonly _defaultSessionId: SessionId;\n\tprivate readonly _sessionTtlMs: number;\n\tprivate readonly _cleanupIntervalMs: number;\n\tprivate readonly _getMaxSessions: () => number;\n\tprivate readonly _maxSessionsPerOwner: number;\n\tprivate readonly _logger: Logger;\n\tprivate _cleanupTimer: ReturnType<typeof setInterval> | null = null;\n\n\tpublic constructor(config: SessionManagerConfig) {\n\t\tthis._defaultSessionId = config.defaultSessionId;\n\t\tthis._sessionTtlMs = config.sessionTtlMs;\n\t\tthis._cleanupIntervalMs = config.cleanupIntervalMs;\n\t\tthis._getMaxSessions = config.getMaxSessions;\n\t\tthis._maxSessionsPerOwner = config.maxSessionsPerOwner ?? 50;\n\t\tthis._logger = config.logger ?? new NullLogger();\n\t}\n\n\t/** @returns The periodic cleanup timer, when active. */\n\tpublic get timer(): ReturnType<typeof setInterval> | null {\n\t\treturn this._cleanupTimer;\n\t}\n\n\t/**\n\t * Starts periodic TTL candidate cleanup and observes every asynchronous rejection.\n\t */\n\tpublic startCleanupTimer(\n\t\tsessions: Map<SessionId, S>,\n\t\tisEligible: SessionEligibility<S>,\n\t\tcleanup: (sessionIds: readonly SessionId[]) => Promise<void>\n\t): void {\n\t\tif (this._cleanupTimer !== null) return;\n\t\tthis._cleanupTimer = setInterval(() => {\n\t\t\tconst candidates = this.staleSessionCandidates(sessions, isEligible);\n\t\t\tif (candidates.length === 0) return;\n\t\t\tvoid Promise.resolve()\n\t\t\t\t.then(() => cleanup(candidates))\n\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\tthis._logger.error('Session cleanup failed', { error });\n\t\t\t\t});\n\t\t}, this._cleanupIntervalMs);\n\t\tif (typeof this._cleanupTimer === 'object' && 'unref' in this._cleanupTimer) {\n\t\t\tthis._cleanupTimer.unref();\n\t\t}\n\t}\n\n\t/** Stops the periodic cleanup timer. */\n\tpublic stopCleanupTimer(): void {\n\t\tif (this._cleanupTimer === null) return;\n\t\tclearInterval(this._cleanupTimer);\n\t\tthis._cleanupTimer = null;\n\t}\n\n\t/**\n\t * Plans the complete victim union required before admitting one prospective session.\n\t *\n\t * Owner quota need is selected first. Those victims also satisfy global need, then\n\t * oldest globally eligible alternatives fill any remainder. `undefined` means no\n\t * complete eligible set exists; the input map is never modified.\n\t */\n\tpublic planProspectiveAdmission(\n\t\tsessions: ReadonlyMap<SessionId, S>,\n\t\towner: string | undefined,\n\t\tisEligible: SessionEligibility<S>\n\t): readonly SessionId[] | undefined {\n\t\tconst live = this._orderedLiveCandidates(sessions);\n\t\tconst selected: Candidate<S>[] = [];\n\t\tif (owner !== undefined) {\n\t\t\tconst ownerCount = live.filter((candidate) => candidate.session.owner === owner).length;\n\t\t\tconst ownerNeed = Math.max(0, ownerCount + 1 - this._maxSessionsPerOwner);\n\t\t\tselected.push(\n\t\t\t\t...live\n\t\t\t\t\t.filter(\n\t\t\t\t\t\t(candidate) =>\n\t\t\t\t\t\t\tcandidate.session.owner === owner &&\n\t\t\t\t\t\t\tcandidate.sessionId !== this._defaultSessionId &&\n\t\t\t\t\t\t\tisEligible(candidate.sessionId, candidate.session)\n\t\t\t\t\t)\n\t\t\t\t\t.slice(0, ownerNeed)\n\t\t\t);\n\t\t\tif (selected.length < ownerNeed) return undefined;\n\t\t}\n\n\t\tconst globalNeed = Math.max(0, live.length + 1 - this._getMaxSessions());\n\t\tconst remainingNeed = Math.max(0, globalNeed - selected.length);\n\t\tconst selectedIds = new Set(selected.map((candidate) => candidate.sessionId));\n\t\tconst alternatives = live.filter(\n\t\t\t(candidate) =>\n\t\t\t\tcandidate.sessionId !== this._defaultSessionId &&\n\t\t\t\t!selectedIds.has(candidate.sessionId) &&\n\t\t\t\tisEligible(candidate.sessionId, candidate.session)\n\t\t);\n\t\tif (alternatives.length < remainingNeed) return undefined;\n\t\tselected.push(...alternatives.slice(0, remainingNeed));\n\t\treturn selected.map((candidate) => candidate.sessionId);\n\t}\n\n\t/** Returns stable oldest-first TTL candidates under the same eligibility rules. */\n\tpublic staleSessionCandidates(\n\t\tsessions: ReadonlyMap<SessionId, S>,\n\t\tisEligible: SessionEligibility<S>,\n\t\tnow: number = Date.now()\n\t): readonly SessionId[] {\n\t\treturn this._orderedLiveCandidates(sessions)\n\t\t\t.filter(\n\t\t\t\t(candidate) =>\n\t\t\t\t\tcandidate.sessionId !== this._defaultSessionId &&\n\t\t\t\t\tnow - candidate.session.lastAccessedAt > this._sessionTtlMs &&\n\t\t\t\t\tisEligible(candidate.sessionId, candidate.session)\n\t\t\t)\n\t\t\t.map((candidate) => candidate.sessionId);\n\t}\n\n\tprivate _orderedLiveCandidates(sessions: ReadonlyMap<SessionId, S>): Candidate<S>[] {\n\t\tconst candidates: Candidate<S>[] = [];\n\t\tlet insertionOrder = 0;\n\t\tfor (const [sessionId, session] of sessions) {\n\t\t\tif (session.provenance !== 'restored') {\n\t\t\t\tcandidates.push({ sessionId, session, insertionOrder });\n\t\t\t}\n\t\t\tinsertionOrder += 1;\n\t\t}\n\t\treturn candidates.sort(\n\t\t\t(left, right) =>\n\t\t\t\tleft.session.lastAccessedAt - right.session.lastAccessedAt ||\n\t\t\t\tleft.insertionOrder - right.insertionOrder\n\t\t);\n\t}\n}\n"],"names":["SessionManager","config","NullLogger","sessions","isEligible","cleanup","setInterval","candidates","Promise","error","clearInterval","owner","live","selected","undefined","ownerCount","candidate","ownerNeed","Math","globalNeed","remainingNeed","selectedIds","Set","alternatives","now","Date","insertionOrder","sessionId","session","left","right"],"mappings":"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"}
+{"version":3,"file":"core/SessionManager.js","sources":["../../src/core/SessionManager.ts"],"sourcesContent":["/**\n * Deterministic session cleanup candidate policy and periodic timer.\n *\n * @module SessionManager\n */\n\nimport type { SessionId } from '../contracts/ids.js';\nimport { NullLogger } from '../logger/NullLogger.js';\nimport type { Logger } from '../logger/StructuredLogger.js';\n\n/** Minimal session facts needed by capacity and TTL policy. */\nexport interface SessionLike {\n\treadonly lastAccessedAt: number;\n\treadonly owner?: string;\n\treadonly provenance?: 'restored';\n}\n\n/** Determines whether a candidate can be removed at this instant. */\nexport type SessionEligibility<S extends SessionLike> = (\n\tsessionId: SessionId,\n\tsession: S\n) => boolean;\n\n/** Configuration options for {@link SessionManager}. */\nexport interface SessionManagerConfig {\n\treadonly sessionTtlMs: number;\n\treadonly cleanupIntervalMs: number;\n\treadonly getMaxSessions: () => number;\n\treadonly maxSessionsPerOwner?: number;\n\treadonly logger?: Logger;\n}\n\ntype Candidate<S extends SessionLike> = {\n\treadonly sessionId: SessionId;\n\treadonly session: S;\n\treadonly insertionOrder: number;\n};\n\n/**\n * Produces complete candidate sets but never mutates the caller-owned session map.\n *\n * @example\n * ```ts\n * const victims = manager.planProspectiveAdmission(sessions, owner, lifecycle.isIdle);\n * ```\n */\nexport class SessionManager<S extends SessionLike> {\n\tprivate readonly _sessionTtlMs: number;\n\tprivate readonly _cleanupIntervalMs: number;\n\tprivate readonly _getMaxSessions: () => number;\n\tprivate readonly _maxSessionsPerOwner: number;\n\tprivate readonly _logger: Logger;\n\tprivate _cleanupTimer: ReturnType<typeof setInterval> | null = null;\n\n\tpublic constructor(config: SessionManagerConfig) {\n\t\tthis._sessionTtlMs = config.sessionTtlMs;\n\t\tthis._cleanupIntervalMs = config.cleanupIntervalMs;\n\t\tthis._getMaxSessions = config.getMaxSessions;\n\t\tthis._maxSessionsPerOwner = config.maxSessionsPerOwner ?? 50;\n\t\tthis._logger = config.logger ?? new NullLogger();\n\t}\n\n\t/** @returns The periodic cleanup timer, when active. */\n\tpublic get timer(): ReturnType<typeof setInterval> | null {\n\t\treturn this._cleanupTimer;\n\t}\n\n\t/**\n\t * Starts periodic TTL candidate cleanup and observes every asynchronous rejection.\n\t */\n\tpublic startCleanupTimer(\n\t\tsessions: Map<SessionId, S>,\n\t\tisEligible: SessionEligibility<S>,\n\t\tcleanup: (sessionIds: readonly SessionId[]) => Promise<void>\n\t): void {\n\t\tif (this._cleanupTimer !== null) return;\n\t\tthis._cleanupTimer = setInterval(() => {\n\t\t\tconst candidates = this.staleSessionCandidates(sessions, isEligible);\n\t\t\tif (candidates.length === 0) return;\n\t\t\tvoid Promise.resolve()\n\t\t\t\t.then(() => cleanup(candidates))\n\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\tthis._logger.error('Session cleanup failed', { error });\n\t\t\t\t});\n\t\t}, this._cleanupIntervalMs);\n\t\tif (typeof this._cleanupTimer === 'object' && 'unref' in this._cleanupTimer) {\n\t\t\tthis._cleanupTimer.unref();\n\t\t}\n\t}\n\n\t/** Stops the periodic cleanup timer. */\n\tpublic stopCleanupTimer(): void {\n\t\tif (this._cleanupTimer === null) return;\n\t\tclearInterval(this._cleanupTimer);\n\t\tthis._cleanupTimer = null;\n\t}\n\n\t/**\n\t * Plans the complete victim union required before admitting one prospective session.\n\t *\n\t * Owner quota need is selected first. Those victims also satisfy global need, then\n\t * oldest globally eligible alternatives fill any remainder. `undefined` means no\n\t * complete eligible set exists; the input map is never modified.\n\t */\n\tpublic planProspectiveAdmission(\n\t\tsessions: ReadonlyMap<SessionId, S>,\n\t\towner: string | undefined,\n\t\tisEligible: SessionEligibility<S>\n\t): readonly SessionId[] | undefined {\n\t\tconst live = this._orderedLiveCandidates(sessions);\n\t\tconst selected: Candidate<S>[] = [];\n\t\tif (owner !== undefined) {\n\t\t\tconst ownerCount = live.filter((candidate) => candidate.session.owner === owner).length;\n\t\t\tconst ownerNeed = Math.max(0, ownerCount + 1 - this._maxSessionsPerOwner);\n\t\t\tselected.push(\n\t\t\t\t...live\n\t\t\t\t\t.filter(\n\t\t\t\t\t\t(candidate) =>\n\t\t\t\t\t\t\tcandidate.session.owner === owner &&\n\t\t\t\t\t\t\tisEligible(candidate.sessionId, candidate.session)\n\t\t\t\t\t)\n\t\t\t\t\t.slice(0, ownerNeed)\n\t\t\t);\n\t\t\tif (selected.length < ownerNeed) return undefined;\n\t\t}\n\n\t\tconst globalNeed = Math.max(0, live.length + 1 - this._getMaxSessions());\n\t\tconst remainingNeed = Math.max(0, globalNeed - selected.length);\n\t\tconst selectedIds = new Set(selected.map((candidate) => candidate.sessionId));\n\t\tconst alternatives = live.filter(\n\t\t\t(candidate) =>\n\t\t\t\t!selectedIds.has(candidate.sessionId) && isEligible(candidate.sessionId, candidate.session)\n\t\t);\n\t\tif (alternatives.length < remainingNeed) return undefined;\n\t\tselected.push(...alternatives.slice(0, remainingNeed));\n\t\treturn selected.map((candidate) => candidate.sessionId);\n\t}\n\n\t/** Returns stable oldest-first TTL candidates under the same eligibility rules. */\n\tpublic staleSessionCandidates(\n\t\tsessions: ReadonlyMap<SessionId, S>,\n\t\tisEligible: SessionEligibility<S>,\n\t\tnow: number = Date.now()\n\t): readonly SessionId[] {\n\t\treturn this._orderedLiveCandidates(sessions)\n\t\t\t.filter(\n\t\t\t\t(candidate) =>\n\t\t\t\t\tnow - candidate.session.lastAccessedAt > this._sessionTtlMs &&\n\t\t\t\t\tisEligible(candidate.sessionId, candidate.session)\n\t\t\t)\n\t\t\t.map((candidate) => candidate.sessionId);\n\t}\n\n\tprivate _orderedLiveCandidates(sessions: ReadonlyMap<SessionId, S>): Candidate<S>[] {\n\t\tconst candidates: Candidate<S>[] = [];\n\t\tlet insertionOrder = 0;\n\t\tfor (const [sessionId, session] of sessions) {\n\t\t\tif (session.provenance !== 'restored') {\n\t\t\t\tcandidates.push({ sessionId, session, insertionOrder });\n\t\t\t}\n\t\t\tinsertionOrder += 1;\n\t\t}\n\t\treturn candidates.sort(\n\t\t\t(left, right) =>\n\t\t\t\tleft.session.lastAccessedAt - right.session.lastAccessedAt ||\n\t\t\t\tleft.insertionOrder - right.insertionOrder\n\t\t);\n\t}\n}\n"],"names":["SessionManager","config","NullLogger","sessions","isEligible","cleanup","setInterval","candidates","Promise","error","clearInterval","owner","live","selected","undefined","ownerCount","candidate","ownerNeed","Math","globalNeed","remainingNeed","selectedIds","Set","alternatives","now","Date","insertionOrder","sessionId","session","left","right"],"mappings":"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"}

package/dist/core/SessionResetCoordinator.d.ts

@@ -7,26 +7,29 @@ interface ResetBarrier {
     withSessionResetBarrier(sessionId: SessionId, operation: () => Promise<void>): Promise<void>;
     withGlobalResetBarrier(operation: () => Promise<void>): Promise<void>;
 }
-export interface SessionResetCoordinatorConfig<SessionState> {
-    readonly persistence: PersistenceBackend | null;
-    readonly barrier: ResetBarrier | null;
+interface SessionResetCoordinatorBaseConfig<SessionState> {
     readonly edgeStore?: IEdgeStore;
     readonly summaryStore?: ISummaryStore;
     readonly sessions: Map<SessionId, SessionState>;
     readonly createSessionState: (owner: string | undefined) => SessionState;
     readonly logger: Logger;
 }
+type ResetDurability = {
+    readonly persistence: null;
+    readonly barrier: null;
+} | {
+    readonly persistence: PersistenceBackend;
+    readonly barrier: ResetBarrier;
+};
+export type SessionResetCoordinatorConfig<SessionState> = SessionResetCoordinatorBaseConfig<SessionState> & ResetDurability;
 export declare class SessionResetCoordinator<SessionState> {
-    private readonly _persistence;
-    private readonly _barrier;
+    private readonly _durability;
     private readonly _edgeStore?;
     private readonly _summaryStore?;
     private readonly _sessions;
     private readonly _createSessionState;
     private readonly _logger;
     constructor(config: SessionResetCoordinatorConfig<SessionState>);
-    clearSession(sessionId: SessionId): void;
-    clearAll(): void;
     resetSession(sessionId: SessionId, preservedOwner: string | undefined, clearAuxiliaryState?: () => void): Promise<void>;
     resetAll(clearAuxiliaryState?: () => void): Promise<void>;
     private _replaceLiveSession;

package/dist/core/SessionResetCoordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionResetCoordinator.d.ts","sourceRoot":"","sources":["../../src/core/SessionResetCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAI5D,UAAU,YAAY;IACrB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7F,sBAAsB,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,6BAA6B,CAAC,YAAY;IAC1D,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAChD,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,YAAY,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,uBAAuB,CAAC,YAAY;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8C;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,6BAA6B,CAAC,YAAY,CAAC;IAU/D,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAOxC,QAAQ,IAAI,IAAI;IAKV,YAAY,CACjB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,mBAAmB,CAAC,EAAE,MAAM,IAAI,GAC9B,OAAO,CAAC,IAAI,CAAC;IAeV,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/D,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,kBAAkB;CAM1B"}
+{"version":3,"file":"SessionResetCoordinator.d.ts","sourceRoot":"","sources":["../../src/core/SessionResetCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,UAAU,YAAY;IACrB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7F,sBAAsB,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,UAAU,iCAAiC,CAAC,YAAY;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAChD,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,YAAY,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,eAAe,GACjB;IAAE,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,6BAA6B,CAAC,YAAY,IACrD,iCAAiC,CAAC,YAAY,CAAC,GAAG,eAAe,CAAC;AAEnE,qBAAa,uBAAuB,CAAC,YAAY;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8C;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,6BAA6B,CAAC,YAAY,CAAC;IASzD,YAAY,CACjB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,mBAAmB,CAAC,EAAE,MAAM,IAAI,GAC9B,OAAO,CAAC,IAAI,CAAC;IAcV,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/D,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,kBAAkB;CAM1B"}

package/dist/core/SessionResetCoordinator.js

@@ -1,58 +1,40 @@
-import { requireSessionScopedPersistence } from "../persistence/SessionScopedPersistence.js";
-import { AsyncResetRequiredError } from "./SessionErrors.js";
 class SessionResetCoordinator {
-    _persistence;
-    _barrier;
+    _durability;
     _edgeStore;
     _summaryStore;
     _sessions;
     _createSessionState;
     _logger;
     constructor(config){
-        this._persistence = config.persistence;
-        this._barrier = config.barrier;
+        this._durability = config;
         this._edgeStore = config.edgeStore;
         this._summaryStore = config.summaryStore;
         this._sessions = config.sessions;
         this._createSessionState = config.createSessionState;
         this._logger = config.logger;
     }
-    clearSession(sessionId) {
-        if (null !== this._persistence) throw new AsyncResetRequiredError('session', sessionId);
-        this._clearSessionStores(sessionId);
-        this._sessions.delete(sessionId);
-        this._logger.info('Session cleared', {
-            sessionId
-        });
-    }
-    clearAll() {
-        if (null !== this._persistence) throw new AsyncResetRequiredError('all');
-        this._clearAllLiveState();
-    }
     async resetSession(sessionId, preservedOwner, clearAuxiliaryState) {
-        if (null === this._persistence) {
+        const durability = this._durability;
+        if (null === durability.persistence) {
             this._replaceLiveSession(sessionId, preservedOwner);
             clearAuxiliaryState?.();
             return;
         }
-        const scopedPersistence = requireSessionScopedPersistence(this._persistence, 'clearSession');
-        if (null === this._barrier) throw new AsyncResetRequiredError('session', sessionId);
-        await this._barrier.withSessionResetBarrier(sessionId, async ()=>{
-            await scopedPersistence.clearSession(sessionId);
+        await durability.barrier.withSessionResetBarrier(sessionId, async ()=>{
+            await durability.persistence.clearSession(sessionId);
             this._replaceLiveSession(sessionId, preservedOwner);
             clearAuxiliaryState?.();
         });
     }
     async resetAll(clearAuxiliaryState) {
-        const persistence = this._persistence;
-        if (null === persistence) {
+        const durability = this._durability;
+        if (null === durability.persistence) {
             this._clearAllLiveState();
             clearAuxiliaryState?.();
             return;
         }
-        if (null === this._barrier) throw new AsyncResetRequiredError('all');
-        await this._barrier.withGlobalResetBarrier(async ()=>{
-            await persistence.clear();
+        await durability.barrier.withGlobalResetBarrier(async ()=>{
+            await durability.persistence.clearAll();
             this._clearAllLiveState();
             clearAuxiliaryState?.();
         });

package/dist/core/SessionResetCoordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"core/SessionResetCoordinator.js","sources":["../../src/core/SessionResetCoordinator.ts"],"sourcesContent":["import type { PersistenceBackend } from '../contracts/PersistenceBackend.js';\nimport type { IEdgeStore } from '../contracts/interfaces.js';\nimport type { SessionId } from '../contracts/ids.js';\nimport type { ISummaryStore } from '../contracts/summary.js';\nimport type { Logger } from '../logger/StructuredLogger.js';\nimport { requireSessionScopedPersistence } from '../persistence/SessionScopedPersistence.js';\nimport { AsyncResetRequiredError } from './SessionErrors.js';\n\ninterface ResetBarrier {\n\twithSessionResetBarrier(sessionId: SessionId, operation: () => Promise<void>): Promise<void>;\n\twithGlobalResetBarrier(operation: () => Promise<void>): Promise<void>;\n}\n\nexport interface SessionResetCoordinatorConfig<SessionState> {\n\treadonly persistence: PersistenceBackend | null;\n\treadonly barrier: ResetBarrier | null;\n\treadonly edgeStore?: IEdgeStore;\n\treadonly summaryStore?: ISummaryStore;\n\treadonly sessions: Map<SessionId, SessionState>;\n\treadonly createSessionState: (owner: string | undefined) => SessionState;\n\treadonly logger: Logger;\n}\n\nexport class SessionResetCoordinator<SessionState> {\n\tprivate readonly _persistence: PersistenceBackend | null;\n\tprivate readonly _barrier: ResetBarrier | null;\n\tprivate readonly _edgeStore?: IEdgeStore;\n\tprivate readonly _summaryStore?: ISummaryStore;\n\tprivate readonly _sessions: Map<SessionId, SessionState>;\n\tprivate readonly _createSessionState: (owner: string | undefined) => SessionState;\n\tprivate readonly _logger: Logger;\n\n\tconstructor(config: SessionResetCoordinatorConfig<SessionState>) {\n\t\tthis._persistence = config.persistence;\n\t\tthis._barrier = config.barrier;\n\t\tthis._edgeStore = config.edgeStore;\n\t\tthis._summaryStore = config.summaryStore;\n\t\tthis._sessions = config.sessions;\n\t\tthis._createSessionState = config.createSessionState;\n\t\tthis._logger = config.logger;\n\t}\n\n\tclearSession(sessionId: SessionId): void {\n\t\tif (this._persistence !== null) throw new AsyncResetRequiredError('session', sessionId);\n\t\tthis._clearSessionStores(sessionId);\n\t\tthis._sessions.delete(sessionId);\n\t\tthis._logger.info('Session cleared', { sessionId });\n\t}\n\n\tclearAll(): void {\n\t\tif (this._persistence !== null) throw new AsyncResetRequiredError('all');\n\t\tthis._clearAllLiveState();\n\t}\n\n\tasync resetSession(\n\t\tsessionId: SessionId,\n\t\tpreservedOwner: string | undefined,\n\t\tclearAuxiliaryState?: () => void\n\t): Promise<void> {\n\t\tif (this._persistence === null) {\n\t\t\tthis._replaceLiveSession(sessionId, preservedOwner);\n\t\t\tclearAuxiliaryState?.();\n\t\t\treturn;\n\t\t}\n\t\tconst scopedPersistence = requireSessionScopedPersistence(this._persistence, 'clearSession');\n\t\tif (this._barrier === null) throw new AsyncResetRequiredError('session', sessionId);\n\t\tawait this._barrier.withSessionResetBarrier(sessionId, async () => {\n\t\t\tawait scopedPersistence.clearSession(sessionId);\n\t\t\tthis._replaceLiveSession(sessionId, preservedOwner);\n\t\t\tclearAuxiliaryState?.();\n\t\t});\n\t}\n\n\tasync resetAll(clearAuxiliaryState?: () => void): Promise<void> {\n\t\tconst persistence = this._persistence;\n\t\tif (persistence === null) {\n\t\t\tthis._clearAllLiveState();\n\t\t\tclearAuxiliaryState?.();\n\t\t\treturn;\n\t\t}\n\t\tif (this._barrier === null) throw new AsyncResetRequiredError('all');\n\t\tawait this._barrier.withGlobalResetBarrier(async () => {\n\t\t\tawait persistence.clear();\n\t\t\tthis._clearAllLiveState();\n\t\t\tclearAuxiliaryState?.();\n\t\t});\n\t}\n\n\tprivate _replaceLiveSession(sessionId: SessionId, owner: string | undefined): void {\n\t\tthis._clearSessionStores(sessionId);\n\t\tthis._sessions.set(sessionId, this._createSessionState(owner));\n\t\tthis._logger.info('Session reset', { sessionId });\n\t}\n\n\tprivate _clearSessionStores(sessionId: SessionId): void {\n\t\tthis._edgeStore?.clearSession(sessionId);\n\t\tthis._summaryStore?.clearSession(sessionId);\n\t}\n\n\tprivate _clearAllLiveState(): void {\n\t\tthis._edgeStore?.clearAll();\n\t\tthis._summaryStore?.clearAll();\n\t\tthis._sessions.clear();\n\t\tthis._logger.info('History cleared (all sessions)');\n\t}\n}\n"],"names":["SessionResetCoordinator","config","sessionId","AsyncResetRequiredError","preservedOwner","clearAuxiliaryState","scopedPersistence","requireSessionScopedPersistence","persistence","owner"],"mappings":";;AAuBO,MAAMA;IACK,aAAwC;IACxC,SAA8B;IAC9B,WAAwB;IACxB,cAA8B;IAC9B,UAAwC;IACxC,oBAAiE;IACjE,QAAgB;IAEjC,YAAYC,MAAmD,CAAE;QAChE,IAAI,CAAC,YAAY,GAAGA,OAAO,WAAW;QACtC,IAAI,CAAC,QAAQ,GAAGA,OAAO,OAAO;QAC9B,IAAI,CAAC,UAAU,GAAGA,OAAO,SAAS;QAClC,IAAI,CAAC,aAAa,GAAGA,OAAO,YAAY;QACxC,IAAI,CAAC,SAAS,GAAGA,OAAO,QAAQ;QAChC,IAAI,CAAC,mBAAmB,GAAGA,OAAO,kBAAkB;QACpD,IAAI,CAAC,OAAO,GAAGA,OAAO,MAAM;IAC7B;IAEA,aAAaC,SAAoB,EAAQ;QACxC,IAAI,AAAsB,SAAtB,IAAI,CAAC,YAAY,EAAW,MAAM,IAAIC,wBAAwB,WAAWD;QAC7E,IAAI,CAAC,mBAAmB,CAACA;QACzB,IAAI,CAAC,SAAS,CAAC,MAAM,CAACA;QACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB;YAAEA;QAAU;IAClD;IAEA,WAAiB;QAChB,IAAI,AAAsB,SAAtB,IAAI,CAAC,YAAY,EAAW,MAAM,IAAIC,wBAAwB;QAClE,IAAI,CAAC,kBAAkB;IACxB;IAEA,MAAM,aACLD,SAAoB,EACpBE,cAAkC,EAClCC,mBAAgC,EAChB;QAChB,IAAI,AAAsB,SAAtB,IAAI,CAAC,YAAY,EAAW;YAC/B,IAAI,CAAC,mBAAmB,CAACH,WAAWE;YACpCC;YACA;QACD;QACA,MAAMC,oBAAoBC,gCAAgC,IAAI,CAAC,YAAY,EAAE;QAC7E,IAAI,AAAkB,SAAlB,IAAI,CAAC,QAAQ,EAAW,MAAM,IAAIJ,wBAAwB,WAAWD;QACzE,MAAM,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAACA,WAAW;YACtD,MAAMI,kBAAkB,YAAY,CAACJ;YACrC,IAAI,CAAC,mBAAmB,CAACA,WAAWE;YACpCC;QACD;IACD;IAEA,MAAM,SAASA,mBAAgC,EAAiB;QAC/D,MAAMG,cAAc,IAAI,CAAC,YAAY;QACrC,IAAIA,AAAgB,SAAhBA,aAAsB;YACzB,IAAI,CAAC,kBAAkB;YACvBH;YACA;QACD;QACA,IAAI,AAAkB,SAAlB,IAAI,CAAC,QAAQ,EAAW,MAAM,IAAIF,wBAAwB;QAC9D,MAAM,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YAC1C,MAAMK,YAAY,KAAK;YACvB,IAAI,CAAC,kBAAkB;YACvBH;QACD;IACD;IAEQ,oBAAoBH,SAAoB,EAAEO,KAAyB,EAAQ;QAClF,IAAI,CAAC,mBAAmB,CAACP;QACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAACA,WAAW,IAAI,CAAC,mBAAmB,CAACO;QACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB;YAAEP;QAAU;IAChD;IAEQ,oBAAoBA,SAAoB,EAAQ;QACvD,IAAI,CAAC,UAAU,EAAE,aAAaA;QAC9B,IAAI,CAAC,aAAa,EAAE,aAAaA;IAClC;IAEQ,qBAA2B;QAClC,IAAI,CAAC,UAAU,EAAE;QACjB,IAAI,CAAC,aAAa,EAAE;QACpB,IAAI,CAAC,SAAS,CAAC,KAAK;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB;AACD"}
+{"version":3,"file":"core/SessionResetCoordinator.js","sources":["../../src/core/SessionResetCoordinator.ts"],"sourcesContent":["import type { PersistenceBackend } from '../contracts/PersistenceBackend.js';\nimport type { IEdgeStore } from '../contracts/interfaces.js';\nimport type { SessionId } from '../contracts/ids.js';\nimport type { ISummaryStore } from '../contracts/summary.js';\nimport type { Logger } from '../logger/StructuredLogger.js';\ninterface ResetBarrier {\n\twithSessionResetBarrier(sessionId: SessionId, operation: () => Promise<void>): Promise<void>;\n\twithGlobalResetBarrier(operation: () => Promise<void>): Promise<void>;\n}\n\ninterface SessionResetCoordinatorBaseConfig<SessionState> {\n\treadonly edgeStore?: IEdgeStore;\n\treadonly summaryStore?: ISummaryStore;\n\treadonly sessions: Map<SessionId, SessionState>;\n\treadonly createSessionState: (owner: string | undefined) => SessionState;\n\treadonly logger: Logger;\n}\n\ntype ResetDurability =\n\t| { readonly persistence: null; readonly barrier: null }\n\t| { readonly persistence: PersistenceBackend; readonly barrier: ResetBarrier };\n\nexport type SessionResetCoordinatorConfig<SessionState> =\n\tSessionResetCoordinatorBaseConfig<SessionState> & ResetDurability;\n\nexport class SessionResetCoordinator<SessionState> {\n\tprivate readonly _durability: ResetDurability;\n\tprivate readonly _edgeStore?: IEdgeStore;\n\tprivate readonly _summaryStore?: ISummaryStore;\n\tprivate readonly _sessions: Map<SessionId, SessionState>;\n\tprivate readonly _createSessionState: (owner: string | undefined) => SessionState;\n\tprivate readonly _logger: Logger;\n\n\tconstructor(config: SessionResetCoordinatorConfig<SessionState>) {\n\t\tthis._durability = config;\n\t\tthis._edgeStore = config.edgeStore;\n\t\tthis._summaryStore = config.summaryStore;\n\t\tthis._sessions = config.sessions;\n\t\tthis._createSessionState = config.createSessionState;\n\t\tthis._logger = config.logger;\n\t}\n\n\tasync resetSession(\n\t\tsessionId: SessionId,\n\t\tpreservedOwner: string | undefined,\n\t\tclearAuxiliaryState?: () => void\n\t): Promise<void> {\n\t\tconst durability = this._durability;\n\t\tif (durability.persistence === null) {\n\t\t\tthis._replaceLiveSession(sessionId, preservedOwner);\n\t\t\tclearAuxiliaryState?.();\n\t\t\treturn;\n\t\t}\n\t\tawait durability.barrier.withSessionResetBarrier(sessionId, async () => {\n\t\t\tawait durability.persistence.clearSession(sessionId);\n\t\t\tthis._replaceLiveSession(sessionId, preservedOwner);\n\t\t\tclearAuxiliaryState?.();\n\t\t});\n\t}\n\n\tasync resetAll(clearAuxiliaryState?: () => void): Promise<void> {\n\t\tconst durability = this._durability;\n\t\tif (durability.persistence === null) {\n\t\t\tthis._clearAllLiveState();\n\t\t\tclearAuxiliaryState?.();\n\t\t\treturn;\n\t\t}\n\t\tawait durability.barrier.withGlobalResetBarrier(async () => {\n\t\t\tawait durability.persistence.clearAll();\n\t\t\tthis._clearAllLiveState();\n\t\t\tclearAuxiliaryState?.();\n\t\t});\n\t}\n\n\tprivate _replaceLiveSession(sessionId: SessionId, owner: string | undefined): void {\n\t\tthis._clearSessionStores(sessionId);\n\t\tthis._sessions.set(sessionId, this._createSessionState(owner));\n\t\tthis._logger.info('Session reset', { sessionId });\n\t}\n\n\tprivate _clearSessionStores(sessionId: SessionId): void {\n\t\tthis._edgeStore?.clearSession(sessionId);\n\t\tthis._summaryStore?.clearSession(sessionId);\n\t}\n\n\tprivate _clearAllLiveState(): void {\n\t\tthis._edgeStore?.clearAll();\n\t\tthis._summaryStore?.clearAll();\n\t\tthis._sessions.clear();\n\t\tthis._logger.info('History cleared (all sessions)');\n\t}\n}\n"],"names":["SessionResetCoordinator","config","sessionId","preservedOwner","clearAuxiliaryState","durability","owner"],"mappings":"AAyBO,MAAMA;IACK,YAA6B;IAC7B,WAAwB;IACxB,cAA8B;IAC9B,UAAwC;IACxC,oBAAiE;IACjE,QAAgB;IAEjC,YAAYC,MAAmD,CAAE;QAChE,IAAI,CAAC,WAAW,GAAGA;QACnB,IAAI,CAAC,UAAU,GAAGA,OAAO,SAAS;QAClC,IAAI,CAAC,aAAa,GAAGA,OAAO,YAAY;QACxC,IAAI,CAAC,SAAS,GAAGA,OAAO,QAAQ;QAChC,IAAI,CAAC,mBAAmB,GAAGA,OAAO,kBAAkB;QACpD,IAAI,CAAC,OAAO,GAAGA,OAAO,MAAM;IAC7B;IAEA,MAAM,aACLC,SAAoB,EACpBC,cAAkC,EAClCC,mBAAgC,EAChB;QAChB,MAAMC,aAAa,IAAI,CAAC,WAAW;QACnC,IAAIA,AAA2B,SAA3BA,WAAW,WAAW,EAAW;YACpC,IAAI,CAAC,mBAAmB,CAACH,WAAWC;YACpCC;YACA;QACD;QACA,MAAMC,WAAW,OAAO,CAAC,uBAAuB,CAACH,WAAW;YAC3D,MAAMG,WAAW,WAAW,CAAC,YAAY,CAACH;YAC1C,IAAI,CAAC,mBAAmB,CAACA,WAAWC;YACpCC;QACD;IACD;IAEA,MAAM,SAASA,mBAAgC,EAAiB;QAC/D,MAAMC,aAAa,IAAI,CAAC,WAAW;QACnC,IAAIA,AAA2B,SAA3BA,WAAW,WAAW,EAAW;YACpC,IAAI,CAAC,kBAAkB;YACvBD;YACA;QACD;QACA,MAAMC,WAAW,OAAO,CAAC,sBAAsB,CAAC;YAC/C,MAAMA,WAAW,WAAW,CAAC,QAAQ;YACrC,IAAI,CAAC,kBAAkB;YACvBD;QACD;IACD;IAEQ,oBAAoBF,SAAoB,EAAEI,KAAyB,EAAQ;QAClF,IAAI,CAAC,mBAAmB,CAACJ;QACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAACA,WAAW,IAAI,CAAC,mBAAmB,CAACI;QACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB;YAAEJ;QAAU;IAChD;IAEQ,oBAAoBA,SAAoB,EAAQ;QACvD,IAAI,CAAC,UAAU,EAAE,aAAaA;QAC9B,IAAI,CAAC,aAAa,EAAE,aAAaA;IAClC;IAEQ,qBAA2B;QAClC,IAAI,CAAC,UAAU,EAAE;QACjB,IAAI,CAAC,aAAa,EAAE;QACpB,IAAI,CAAC,SAAS,CAAC,KAAK;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB;AACD"}

package/dist/core/ThoughtEvaluator.d.ts

@@ -8,7 +8,7 @@
  * @module core/ThoughtEvaluator
  */
 import type { ICalibrator } from '../contracts/calibrator.js';
-import { type SessionId } from '../contracts/ids.js';
+import type { SessionId } from '../contracts/ids.js';
 import type { ConfidenceSignals, PatternSignal, ReasoningStats } from './reasoning.js';
 import type { ThoughtData } from './thought.js';
 /** Explicit thought and canonical session used for response calibration. */
@@ -26,8 +26,8 @@ export interface ConfidenceSignalContext {
  *
  * @example
  * ```typescript
- * const evaluator = new ThoughtEvaluator();
- * const signals = evaluator.computeConfidenceSignals(history, branches);
+ * const evaluator = new ThoughtEvaluator(calibrator);
+ * const signals = evaluator.computeConfidenceSignals(history, branches, context);
  * const stats = evaluator.computeReasoningStats(history, branches);
  * const patterns = evaluator.computePatternSignals(history, branches);
  * ```
@@ -37,9 +37,9 @@ export declare class ThoughtEvaluator {
     private readonly _aggregator;
     private readonly _patternDetector;
     private readonly _calibrator;
-    constructor(calibrator?: ICalibrator);
+    constructor(calibrator: ICalibrator);
     /** Compute confidence signals from history context. Pure computation. */
-    computeConfidenceSignals(history: ThoughtData[], branches: Record<string, ThoughtData[]>, context?: ConfidenceSignalContext): ConfidenceSignals;
+    computeConfidenceSignals(history: ThoughtData[], branches: Record<string, ThoughtData[]>, context: ConfidenceSignalContext): ConfidenceSignals;
     /** Compute aggregated reasoning analytics. Pure computation. */
     computeReasoningStats(history: ThoughtData[], branches: Record<string, ThoughtData[]>): ReasoningStats;
     /** Detect reasoning patterns (anti-patterns and positive signals). Pure computation. */

package/dist/core/ThoughtEvaluator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThoughtEvaluator.d.ts","sourceRoot":"","sources":["../../src/core/ThoughtEvaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAGX,WAAW,EACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,4EAA4E;AAC5E,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC9B;AAmDD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,UAAU,CAAC,EAAE,WAAW;IAOpC,yEAAyE;IAClE,wBAAwB,CAC9B,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EACvC,OAAO,CAAC,EAAE,uBAAuB,GAC/B,iBAAiB;IAqBpB,gEAAgE;IACzD,qBAAqB,CAC3B,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GACrC,cAAc;IAKjB,wFAAwF;IACjF,qBAAqB,CAC3B,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GACrC,aAAa,EAAE;CAIlB"}
+{"version":3,"file":"ThoughtEvaluator.d.ts","sourceRoot":"","sources":["../../src/core/ThoughtEvaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,4EAA4E;AAC5E,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,UAAU,EAAE,WAAW;IAOnC,yEAAyE;IAClE,wBAAwB,CAC9B,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EACvC,OAAO,EAAE,uBAAuB,GAC9B,iBAAiB;IAqBpB,gEAAgE;IACzD,qBAAqB,CAC3B,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GACrC,cAAc;IAKjB,wFAAwF;IACjF,qBAAqB,CAC3B,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GACrC,aAAa,EAAE;CAIlB"}

package/dist/core/ThoughtEvaluator.js

@@ -1,42 +1,6 @@
-import { GLOBAL_SESSION_ID } from "../contracts/ids.js";
 import { Aggregator } from "./evaluator/Aggregator.js";
 import { PatternDetector } from "./evaluator/PatternDetector.js";
 import { SignalComputer } from "./evaluator/SignalComputer.js";
-class NoOpCalibrator {
-    enabled = false;
-    calibrate(rawConfidence, _type, _sessionId) {
-        const raw = Math.min(1, Math.max(0, rawConfidence));
-        return {
-            raw,
-            calibrated: raw,
-            temperature: 1.0,
-            priorWeight: 0
-        };
-    }
-    metrics(_sessionId) {
-        return {
-            brierScore: null,
-            ece: null,
-            sampleCount: 0,
-            perTypeBrier: {
-                regular: null,
-                hypothesis: null,
-                verification: null,
-                critique: null,
-                synthesis: null,
-                meta: null,
-                tool_call: null,
-                tool_observation: null,
-                assumption: null,
-                decomposition: null,
-                backtrack: null
-            }
-        };
-    }
-    refit(_sessionId) {}
-    clearSession(_sessionId) {}
-    clearAll() {}
-}
 class ThoughtEvaluator {
     _signalComputer;
     _aggregator;
@@ -46,15 +10,15 @@ class ThoughtEvaluator {
         this._signalComputer = new SignalComputer();
         this._aggregator = new Aggregator();
         this._patternDetector = new PatternDetector();
-        this._calibrator = calibrator ?? new NoOpCalibrator();
+        this._calibrator = calibrator;
     }
     computeConfidenceSignals(history, branches, context) {
         const { history: h, branches: b } = filterRetracted(history, branches);
         const signals = this._signalComputer.computeConfidenceSignals(h, b);
         if (!this._calibrator.enabled) return signals;
-        const thought = context?.currentThought ?? h[h.length - 1];
-        if (thought?.confidence === void 0) return signals;
-        const sessionId = context?.sessionId ?? thought.session_id ?? GLOBAL_SESSION_ID;
+        const thought = context.currentThought;
+        if (void 0 === thought.confidence) return signals;
+        const sessionId = context.sessionId;
         const result = this._calibrator.calibrate(thought.confidence, thought.thought_type ?? 'regular', sessionId);
         return {
             ...signals,

package/dist/core/ThoughtEvaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"core/ThoughtEvaluator.js","sources":["../../src/core/ThoughtEvaluator.ts"],"sourcesContent":["/**\n * Quality signal computation for sequential thinking.\n *\n * Thin facade that composes the extracted evaluator submodules\n * ({@link SignalComputer}, {@link Aggregator}, {@link PatternDetector})\n * to preserve the original {@link ThoughtEvaluator} public API.\n *\n * @module core/ThoughtEvaluator\n */\n\nimport type {\n\tCalibrationMetrics,\n\tCalibrationResult,\n\tICalibrator,\n} from '../contracts/calibrator.js';\nimport { GLOBAL_SESSION_ID, type SessionId } from '../contracts/ids.js';\nimport type { ThoughtType } from '../contracts/reasoning-types.js';\nimport type { ConfidenceSignals, PatternSignal, ReasoningStats } from './reasoning.js';\nimport type { ThoughtData } from './thought.js';\nimport { Aggregator } from './evaluator/Aggregator.js';\nimport { PatternDetector } from './evaluator/PatternDetector.js';\nimport { SignalComputer } from './evaluator/SignalComputer.js';\n\n/** Explicit thought and canonical session used for response calibration. */\nexport interface ConfidenceSignalContext {\n\treadonly currentThought: ThoughtData;\n\treadonly sessionId: SessionId;\n}\n\n/**\n * No-op calibrator used when calibration is disabled or no calibrator is injected.\n *\n * @remarks\n * Returns the raw confidence unchanged, exposes `enabled = false`, and reports\n * empty metrics. Keeps the {@link ThoughtEvaluator} constructor zero-arg compatible.\n */\nclass NoOpCalibrator implements ICalibrator {\n\tpublic readonly enabled = false;\n\n\tpublic calibrate(\n\t\trawConfidence: number,\n\t\t_type: ThoughtType,\n\t\t_sessionId: SessionId\n\t): CalibrationResult {\n\t\tconst raw = Math.min(1, Math.max(0, rawConfidence));\n\t\treturn { raw, calibrated: raw, temperature: 1.0, priorWeight: 0 };\n\t}\n\n\tpublic metrics(_sessionId?: SessionId): CalibrationMetrics {\n\t\treturn {\n\t\t\tbrierScore: null,\n\t\t\tece: null,\n\t\t\tsampleCount: 0,\n\t\t\tperTypeBrier: {\n\t\t\t\tregular: null,\n\t\t\t\thypothesis: null,\n\t\t\t\tverification: null,\n\t\t\t\tcritique: null,\n\t\t\t\tsynthesis: null,\n\t\t\t\tmeta: null,\n\t\t\t\ttool_call: null,\n\t\t\t\ttool_observation: null,\n\t\t\t\tassumption: null,\n\t\t\t\tdecomposition: null,\n\t\t\t\tbacktrack: null,\n\t\t\t},\n\t\t};\n\t}\n\n\tpublic refit(_sessionId?: SessionId): void {\n\t\t// no-op\n\t}\n\n\tpublic clearSession(_sessionId: SessionId): void {}\n\n\tpublic clearAll(): void {}\n}\n\n/**\n * Stateless service that computes quality signals and reasoning analytics\n * from thought history and branch data.\n *\n * @remarks\n * All methods are pure computations — no side effects, no I/O, no internal state.\n * Designed to be registered as transient in the DI container.\n *\n * @example\n * ```typescript\n * const evaluator = new ThoughtEvaluator();\n * const signals = evaluator.computeConfidenceSignals(history, branches);\n * const stats = evaluator.computeReasoningStats(history, branches);\n * const patterns = evaluator.computePatternSignals(history, branches);\n * ```\n */\nexport class ThoughtEvaluator {\n\tprivate readonly _signalComputer: SignalComputer;\n\tprivate readonly _aggregator: Aggregator;\n\tprivate readonly _patternDetector: PatternDetector;\n\tprivate readonly _calibrator: ICalibrator;\n\n\tconstructor(calibrator?: ICalibrator) {\n\t\tthis._signalComputer = new SignalComputer();\n\t\tthis._aggregator = new Aggregator();\n\t\tthis._patternDetector = new PatternDetector();\n\t\tthis._calibrator = calibrator ?? new NoOpCalibrator();\n\t}\n\n\t/** Compute confidence signals from history context. Pure computation. */\n\tpublic computeConfidenceSignals(\n\t\thistory: ThoughtData[],\n\t\tbranches: Record<string, ThoughtData[]>,\n\t\tcontext?: ConfidenceSignalContext\n\t): ConfidenceSignals {\n\t\tconst { history: h, branches: b } = filterRetracted(history, branches);\n\t\tconst signals = this._signalComputer.computeConfidenceSignals(h, b);\n\t\tif (!this._calibrator.enabled) return signals;\n\n\t\tconst thought = context?.currentThought ?? h[h.length - 1];\n\t\tif (thought?.confidence === undefined) return signals;\n\t\tconst sessionId = context?.sessionId ?? thought.session_id ?? GLOBAL_SESSION_ID;\n\n\t\tconst result = this._calibrator.calibrate(\n\t\t\tthought.confidence,\n\t\t\tthought.thought_type ?? 'regular',\n\t\t\tsessionId\n\t\t);\n\t\treturn {\n\t\t\t...signals,\n\t\t\tcalibrated_confidence: result.calibrated,\n\t\t\tcalibration_metrics: this._calibrator.metrics(sessionId),\n\t\t};\n\t}\n\n\t/** Compute aggregated reasoning analytics. Pure computation. */\n\tpublic computeReasoningStats(\n\t\thistory: ThoughtData[],\n\t\tbranches: Record<string, ThoughtData[]>\n\t): ReasoningStats {\n\t\tconst { history: h, branches: b } = filterRetracted(history, branches);\n\t\treturn this._aggregator.computeReasoningStats(h, b);\n\t}\n\n\t/** Detect reasoning patterns (anti-patterns and positive signals). Pure computation. */\n\tpublic computePatternSignals(\n\t\thistory: ThoughtData[],\n\t\tbranches: Record<string, ThoughtData[]>\n\t): PatternSignal[] {\n\t\tconst { history: h, branches: b } = filterRetracted(history, branches);\n\t\treturn this._patternDetector.computePatternSignals(h, b);\n\t}\n}\n\n/**\n * Filters out logically retracted thoughts from history and branches.\n * Retracted thoughts remain in storage (event-sourcing) but are excluded\n * from quality signal calculations.\n */\nfunction filterRetracted(\n\thistory: ThoughtData[],\n\tbranches: Record<string, ThoughtData[]>\n): { history: ThoughtData[]; branches: Record<string, ThoughtData[]> } {\n\tconst h = history.filter((t) => !t.retracted);\n\tconst b: Record<string, ThoughtData[]> = {};\n\tfor (const [id, list] of Object.entries(branches)) {\n\t\tb[id] = list.filter((t) => !t.retracted);\n\t}\n\treturn { history: h, branches: b };\n}\n"],"names":["NoOpCalibrator","rawConfidence","_type","_sessionId","raw","Math","ThoughtEvaluator","calibrator","SignalComputer","Aggregator","PatternDetector","history","branches","context","h","b","filterRetracted","signals","thought","undefined","sessionId","GLOBAL_SESSION_ID","result","t","id","list","Object"],"mappings":";;;;AAoCA,MAAMA;IACW,UAAU,MAAM;IAEzB,UACNC,aAAqB,EACrBC,KAAkB,EAClBC,UAAqB,EACD;QACpB,MAAMC,MAAMC,KAAK,GAAG,CAAC,GAAGA,KAAK,GAAG,CAAC,GAAGJ;QACpC,OAAO;YAAEG;YAAK,YAAYA;YAAK,aAAa;YAAK,aAAa;QAAE;IACjE;IAEO,QAAQD,UAAsB,EAAsB;QAC1D,OAAO;YACN,YAAY;YACZ,KAAK;YACL,aAAa;YACb,cAAc;gBACb,SAAS;gBACT,YAAY;gBACZ,cAAc;gBACd,UAAU;gBACV,WAAW;gBACX,MAAM;gBACN,WAAW;gBACX,kBAAkB;gBAClB,YAAY;gBACZ,eAAe;gBACf,WAAW;YACZ;QACD;IACD;IAEO,MAAMA,UAAsB,EAAQ,CAE3C;IAEO,aAAaA,UAAqB,EAAQ,CAAC;IAE3C,WAAiB,CAAC;AAC1B;AAkBO,MAAMG;IACK,gBAAgC;IAChC,YAAwB;IACxB,iBAAkC;IAClC,YAAyB;IAE1C,YAAYC,UAAwB,CAAE;QACrC,IAAI,CAAC,eAAe,GAAG,IAAIC;QAC3B,IAAI,CAAC,WAAW,GAAG,IAAIC;QACvB,IAAI,CAAC,gBAAgB,GAAG,IAAIC;QAC5B,IAAI,CAAC,WAAW,GAAGH,cAAc,IAAIP;IACtC;IAGO,yBACNW,OAAsB,EACtBC,QAAuC,EACvCC,OAAiC,EACb;QACpB,MAAM,EAAE,SAASC,CAAC,EAAE,UAAUC,CAAC,EAAE,GAAGC,gBAAgBL,SAASC;QAC7D,MAAMK,UAAU,IAAI,CAAC,eAAe,CAAC,wBAAwB,CAACH,GAAGC;QACjE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAOE;QAEtC,MAAMC,UAAUL,SAAS,kBAAkBC,CAAC,CAACA,EAAE,MAAM,GAAG,EAAE;QAC1D,IAAII,SAAS,eAAeC,QAAW,OAAOF;QAC9C,MAAMG,YAAYP,SAAS,aAAaK,QAAQ,UAAU,IAAIG;QAE9D,MAAMC,SAAS,IAAI,CAAC,WAAW,CAAC,SAAS,CACxCJ,QAAQ,UAAU,EAClBA,QAAQ,YAAY,IAAI,WACxBE;QAED,OAAO;YACN,GAAGH,OAAO;YACV,uBAAuBK,OAAO,UAAU;YACxC,qBAAqB,IAAI,CAAC,WAAW,CAAC,OAAO,CAACF;QAC/C;IACD;IAGO,sBACNT,OAAsB,EACtBC,QAAuC,EACtB;QACjB,MAAM,EAAE,SAASE,CAAC,EAAE,UAAUC,CAAC,EAAE,GAAGC,gBAAgBL,SAASC;QAC7D,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAACE,GAAGC;IAClD;IAGO,sBACNJ,OAAsB,EACtBC,QAAuC,EACrB;QAClB,MAAM,EAAE,SAASE,CAAC,EAAE,UAAUC,CAAC,EAAE,GAAGC,gBAAgBL,SAASC;QAC7D,OAAO,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAACE,GAAGC;IACvD;AACD;AAOA,SAASC,gBACRL,OAAsB,EACtBC,QAAuC;IAEvC,MAAME,IAAIH,QAAQ,MAAM,CAAC,CAACY,IAAM,CAACA,EAAE,SAAS;IAC5C,MAAMR,IAAmC,CAAC;IAC1C,KAAK,MAAM,CAACS,IAAIC,KAAK,IAAIC,OAAO,OAAO,CAACd,UACvCG,CAAC,CAACS,GAAG,GAAGC,KAAK,MAAM,CAAC,CAACF,IAAM,CAACA,EAAE,SAAS;IAExC,OAAO;QAAE,SAAST;QAAG,UAAUC;IAAE;AAClC"}
+{"version":3,"file":"core/ThoughtEvaluator.js","sources":["../../src/core/ThoughtEvaluator.ts"],"sourcesContent":["/**\n * Quality signal computation for sequential thinking.\n *\n * Thin facade that composes the extracted evaluator submodules\n * ({@link SignalComputer}, {@link Aggregator}, {@link PatternDetector})\n * to preserve the original {@link ThoughtEvaluator} public API.\n *\n * @module core/ThoughtEvaluator\n */\n\nimport type { ICalibrator } from '../contracts/calibrator.js';\nimport type { SessionId } from '../contracts/ids.js';\nimport type { ConfidenceSignals, PatternSignal, ReasoningStats } from './reasoning.js';\nimport type { ThoughtData } from './thought.js';\nimport { Aggregator } from './evaluator/Aggregator.js';\nimport { PatternDetector } from './evaluator/PatternDetector.js';\nimport { SignalComputer } from './evaluator/SignalComputer.js';\n\n/** Explicit thought and canonical session used for response calibration. */\nexport interface ConfidenceSignalContext {\n\treadonly currentThought: ThoughtData;\n\treadonly sessionId: SessionId;\n}\n\n/**\n * Stateless service that computes quality signals and reasoning analytics\n * from thought history and branch data.\n *\n * @remarks\n * All methods are pure computations — no side effects, no I/O, no internal state.\n * Designed to be registered as transient in the DI container.\n *\n * @example\n * ```typescript\n * const evaluator = new ThoughtEvaluator(calibrator);\n * const signals = evaluator.computeConfidenceSignals(history, branches, context);\n * const stats = evaluator.computeReasoningStats(history, branches);\n * const patterns = evaluator.computePatternSignals(history, branches);\n * ```\n */\nexport class ThoughtEvaluator {\n\tprivate readonly _signalComputer: SignalComputer;\n\tprivate readonly _aggregator: Aggregator;\n\tprivate readonly _patternDetector: PatternDetector;\n\tprivate readonly _calibrator: ICalibrator;\n\n\tconstructor(calibrator: ICalibrator) {\n\t\tthis._signalComputer = new SignalComputer();\n\t\tthis._aggregator = new Aggregator();\n\t\tthis._patternDetector = new PatternDetector();\n\t\tthis._calibrator = calibrator;\n\t}\n\n\t/** Compute confidence signals from history context. Pure computation. */\n\tpublic computeConfidenceSignals(\n\t\thistory: ThoughtData[],\n\t\tbranches: Record<string, ThoughtData[]>,\n\t\tcontext: ConfidenceSignalContext\n\t): ConfidenceSignals {\n\t\tconst { history: h, branches: b } = filterRetracted(history, branches);\n\t\tconst signals = this._signalComputer.computeConfidenceSignals(h, b);\n\t\tif (!this._calibrator.enabled) return signals;\n\n\t\tconst thought = context.currentThought;\n\t\tif (thought.confidence === undefined) return signals;\n\t\tconst sessionId = context.sessionId;\n\n\t\tconst result = this._calibrator.calibrate(\n\t\t\tthought.confidence,\n\t\t\tthought.thought_type ?? 'regular',\n\t\t\tsessionId\n\t\t);\n\t\treturn {\n\t\t\t...signals,\n\t\t\tcalibrated_confidence: result.calibrated,\n\t\t\tcalibration_metrics: this._calibrator.metrics(sessionId),\n\t\t};\n\t}\n\n\t/** Compute aggregated reasoning analytics. Pure computation. */\n\tpublic computeReasoningStats(\n\t\thistory: ThoughtData[],\n\t\tbranches: Record<string, ThoughtData[]>\n\t): ReasoningStats {\n\t\tconst { history: h, branches: b } = filterRetracted(history, branches);\n\t\treturn this._aggregator.computeReasoningStats(h, b);\n\t}\n\n\t/** Detect reasoning patterns (anti-patterns and positive signals). Pure computation. */\n\tpublic computePatternSignals(\n\t\thistory: ThoughtData[],\n\t\tbranches: Record<string, ThoughtData[]>\n\t): PatternSignal[] {\n\t\tconst { history: h, branches: b } = filterRetracted(history, branches);\n\t\treturn this._patternDetector.computePatternSignals(h, b);\n\t}\n}\n\n/**\n * Filters out logically retracted thoughts from history and branches.\n * Retracted thoughts remain in storage (event-sourcing) but are excluded\n * from quality signal calculations.\n */\nfunction filterRetracted(\n\thistory: ThoughtData[],\n\tbranches: Record<string, ThoughtData[]>\n): { history: ThoughtData[]; branches: Record<string, ThoughtData[]> } {\n\tconst h = history.filter((t) => !t.retracted);\n\tconst b: Record<string, ThoughtData[]> = {};\n\tfor (const [id, list] of Object.entries(branches)) {\n\t\tb[id] = list.filter((t) => !t.retracted);\n\t}\n\treturn { history: h, branches: b };\n}\n"],"names":["ThoughtEvaluator","calibrator","SignalComputer","Aggregator","PatternDetector","history","branches","context","h","b","filterRetracted","signals","thought","undefined","sessionId","result","t","id","list","Object"],"mappings":";;;AAwCO,MAAMA;IACK,gBAAgC;IAChC,YAAwB;IACxB,iBAAkC;IAClC,YAAyB;IAE1C,YAAYC,UAAuB,CAAE;QACpC,IAAI,CAAC,eAAe,GAAG,IAAIC;QAC3B,IAAI,CAAC,WAAW,GAAG,IAAIC;QACvB,IAAI,CAAC,gBAAgB,GAAG,IAAIC;QAC5B,IAAI,CAAC,WAAW,GAAGH;IACpB;IAGO,yBACNI,OAAsB,EACtBC,QAAuC,EACvCC,OAAgC,EACZ;QACpB,MAAM,EAAE,SAASC,CAAC,EAAE,UAAUC,CAAC,EAAE,GAAGC,gBAAgBL,SAASC;QAC7D,MAAMK,UAAU,IAAI,CAAC,eAAe,CAAC,wBAAwB,CAACH,GAAGC;QACjE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAOE;QAEtC,MAAMC,UAAUL,QAAQ,cAAc;QACtC,IAAIK,AAAuBC,WAAvBD,QAAQ,UAAU,EAAgB,OAAOD;QAC7C,MAAMG,YAAYP,QAAQ,SAAS;QAEnC,MAAMQ,SAAS,IAAI,CAAC,WAAW,CAAC,SAAS,CACxCH,QAAQ,UAAU,EAClBA,QAAQ,YAAY,IAAI,WACxBE;QAED,OAAO;YACN,GAAGH,OAAO;YACV,uBAAuBI,OAAO,UAAU;YACxC,qBAAqB,IAAI,CAAC,WAAW,CAAC,OAAO,CAACD;QAC/C;IACD;IAGO,sBACNT,OAAsB,EACtBC,QAAuC,EACtB;QACjB,MAAM,EAAE,SAASE,CAAC,EAAE,UAAUC,CAAC,EAAE,GAAGC,gBAAgBL,SAASC;QAC7D,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAACE,GAAGC;IAClD;IAGO,sBACNJ,OAAsB,EACtBC,QAAuC,EACrB;QAClB,MAAM,EAAE,SAASE,CAAC,EAAE,UAAUC,CAAC,EAAE,GAAGC,gBAAgBL,SAASC;QAC7D,OAAO,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAACE,GAAGC;IACvD;AACD;AAOA,SAASC,gBACRL,OAAsB,EACtBC,QAAuC;IAEvC,MAAME,IAAIH,QAAQ,MAAM,CAAC,CAACW,IAAM,CAACA,EAAE,SAAS;IAC5C,MAAMP,IAAmC,CAAC;IAC1C,KAAK,MAAM,CAACQ,IAAIC,KAAK,IAAIC,OAAO,OAAO,CAACb,UACvCG,CAAC,CAACQ,GAAG,GAAGC,KAAK,MAAM,CAAC,CAACF,IAAM,CAACA,EAAE,SAAS;IAExC,OAAO;QAAE,SAASR;QAAG,UAAUC;IAAE;AAClC"}

package/dist/core/ThoughtProcessor.d.ts

@@ -63,7 +63,13 @@ export interface CallToolResult extends Record<string, unknown> {
  * @example
  * ```typescript
  * const processor = new ThoughtProcessor(historyManager, formatter, new ThoughtEvaluator());
- * const result = await processor.process({ thought: '...', thought_number: 1, total_thoughts: 5, next_thought_needed: true });
+ * const result = await processor.process({
+ *   thought: '...',
+ *   thought_number: 1,
+ *   total_thoughts: 5,
+ *   next_thought_needed: true,
+ *   session_id: asSessionId('analysis')
+ * });
  * ```
  */
 export declare class ThoughtProcessor {
@@ -161,7 +167,8 @@ export declare class ThoughtProcessor {
      *   thought: 'I should read the README file',
      *   thought_number: 1,
      *   total_thoughts: 3,
-     *   next_thought_needed: true
+     *   next_thought_needed: true,
+     *   session_id: asSessionId('analysis')
      * });
      *
      * console.log(result.content[0].text);
@@ -195,7 +202,7 @@ export declare class ThoughtProcessor {
     /**
      * Locate the root thought id for a branch.
      * Prefers GraphView.branchThoughts() when an EdgeStore is available;
-     * falls back to historyManager.getBranches()[branchId][0].id.
+     * falls back to historyManager.getBranches(sessionId)[branchId][0].id.
      * @private
      */
     private _findBranchRoot;