@iworkforces/tracelattice 2.0.3

package/dist/core/SessionManager.js.map

@@ -0,0 +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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"}

package/dist/core/SessionResetCoordinator.d.ts

@@ -0,0 +1,37 @@
+import type { PersistenceBackend } from '../contracts/PersistenceBackend.js';
+import type { IEdgeStore } from '../contracts/interfaces.js';
+import type { SessionId } from '../contracts/ids.js';
+import type { ISummaryStore } from '../contracts/summary.js';
+import type { Logger } from '../logger/StructuredLogger.js';
+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;
+    readonly edgeStore?: IEdgeStore;
+    readonly summaryStore?: ISummaryStore;
+    readonly sessions: Map<SessionId, SessionState>;
+    readonly createSessionState: (owner: string | undefined) => SessionState;
+    readonly logger: Logger;
+}
+export declare class SessionResetCoordinator<SessionState> {
+    private readonly _persistence;
+    private readonly _barrier;
+    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;
+    private _clearSessionStores;
+    private _clearAllLiveState;
+}
+export {};
+//# sourceMappingURL=SessionResetCoordinator.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/SessionResetCoordinator.js

@@ -0,0 +1,80 @@
+import { requireSessionScopedPersistence } from "../persistence/SessionScopedPersistence.js";
+import { AsyncResetRequiredError } from "./SessionErrors.js";
+class SessionResetCoordinator {
+    _persistence;
+    _barrier;
+    _edgeStore;
+    _summaryStore;
+    _sessions;
+    _createSessionState;
+    _logger;
+    constructor(config){
+        this._persistence = config.persistence;
+        this._barrier = config.barrier;
+        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) {
+            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);
+            this._replaceLiveSession(sessionId, preservedOwner);
+            clearAuxiliaryState?.();
+        });
+    }
+    async resetAll(clearAuxiliaryState) {
+        const persistence = this._persistence;
+        if (null === persistence) {
+            this._clearAllLiveState();
+            clearAuxiliaryState?.();
+            return;
+        }
+        if (null === this._barrier) throw new AsyncResetRequiredError('all');
+        await this._barrier.withGlobalResetBarrier(async ()=>{
+            await persistence.clear();
+            this._clearAllLiveState();
+            clearAuxiliaryState?.();
+        });
+    }
+    _replaceLiveSession(sessionId, owner) {
+        this._clearSessionStores(sessionId);
+        this._sessions.set(sessionId, this._createSessionState(owner));
+        this._logger.info('Session reset', {
+            sessionId
+        });
+    }
+    _clearSessionStores(sessionId) {
+        this._edgeStore?.clearSession(sessionId);
+        this._summaryStore?.clearSession(sessionId);
+    }
+    _clearAllLiveState() {
+        this._edgeStore?.clearAll();
+        this._summaryStore?.clearAll();
+        this._sessions.clear();
+        this._logger.info('History cleared (all sessions)');
+    }
+}
+export { SessionResetCoordinator };
+
+//# sourceMappingURL=SessionResetCoordinator.js.map

package/dist/core/SessionResetCoordinator.js.map

@@ -0,0 +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"}

package/dist/core/ThoughtEvaluator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Quality signal computation for sequential thinking.
+ *
+ * Thin facade that composes the extracted evaluator submodules
+ * ({@link SignalComputer}, {@link Aggregator}, {@link PatternDetector})
+ * to preserve the original {@link ThoughtEvaluator} public API.
+ *
+ * @module core/ThoughtEvaluator
+ */
+import type { ICalibrator } from '../contracts/calibrator.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. */
+export interface ConfidenceSignalContext {
+    readonly currentThought: ThoughtData;
+    readonly sessionId: SessionId;
+}
+/**
+ * Stateless service that computes quality signals and reasoning analytics
+ * from thought history and branch data.
+ *
+ * @remarks
+ * All methods are pure computations — no side effects, no I/O, no internal state.
+ * Designed to be registered as transient in the DI container.
+ *
+ * @example
+ * ```typescript
+ * const evaluator = new ThoughtEvaluator();
+ * const signals = evaluator.computeConfidenceSignals(history, branches);
+ * const stats = evaluator.computeReasoningStats(history, branches);
+ * const patterns = evaluator.computePatternSignals(history, branches);
+ * ```
+ */
+export declare class ThoughtEvaluator {
+    private readonly _signalComputer;
+    private readonly _aggregator;
+    private readonly _patternDetector;
+    private readonly _calibrator;
+    constructor(calibrator?: ICalibrator);
+    /** Compute confidence signals from history context. Pure computation. */
+    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. */
+    computePatternSignals(history: ThoughtData[], branches: Record<string, ThoughtData[]>): PatternSignal[];
+}
+//# sourceMappingURL=ThoughtEvaluator.d.ts.map

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

@@ -0,0 +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;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AACpG,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"}

package/dist/core/ThoughtEvaluator.js

@@ -0,0 +1,85 @@
+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;
+    _patternDetector;
+    _calibrator;
+    constructor(calibrator){
+        this._signalComputer = new SignalComputer();
+        this._aggregator = new Aggregator();
+        this._patternDetector = new PatternDetector();
+        this._calibrator = calibrator ?? new NoOpCalibrator();
+    }
+    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 result = this._calibrator.calibrate(thought.confidence, thought.thought_type ?? 'regular', sessionId);
+        return {
+            ...signals,
+            calibrated_confidence: result.calibrated,
+            calibration_metrics: this._calibrator.metrics(sessionId)
+        };
+    }
+    computeReasoningStats(history, branches) {
+        const { history: h, branches: b } = filterRetracted(history, branches);
+        return this._aggregator.computeReasoningStats(h, b);
+    }
+    computePatternSignals(history, branches) {
+        const { history: h, branches: b } = filterRetracted(history, branches);
+        return this._patternDetector.computePatternSignals(h, b);
+    }
+}
+function filterRetracted(history, branches) {
+    const h = history.filter((t)=>!t.retracted);
+    const b = {};
+    for (const [id, list] of Object.entries(branches))b[id] = list.filter((t)=>!t.retracted);
+    return {
+        history: h,
+        branches: b
+    };
+}
+export { ThoughtEvaluator };
+
+//# sourceMappingURL=ThoughtEvaluator.js.map

package/dist/core/ThoughtEvaluator.js.map

@@ -0,0 +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 { ConfidenceSignals, PatternSignal, ReasoningStats, ThoughtType } 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":";;;;AAmCA,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"}

package/dist/core/ThoughtFormatter.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Display formatting for thoughts and recommendations.
+ *
+ * This module provides the `ThoughtFormatter` class which handles all
+ * presentation logic for thought data, including clean, simple output
+ * formatting and structured display of tool/skill recommendations.
+ *
+ * @module formatter
+ */
+import type { IThoughtFormatter } from './IThoughtFormatter.js';
+import type { StepRecommendation } from './step.js';
+import type { ThoughtData } from './thought.js';
+/**
+ * Formatter for thought data and step recommendations.
+ *
+ * This class separates presentation concerns from business logic, providing
+ * clean, readable output for thoughts with structured display of
+ * tool and skill recommendations.
+ *
+ * @remarks
+ * Output Format is clean and simple:
+ * - 💭 Thought - Regular thought (blue)
+ * - 🔬 Hypothesis - Proposed explanation (magenta)
+ * - ✅ Verification - Testing a hypothesis (green)
+ * - 🔍 Critique - Self-critique of reasoning (red)
+ * - 🧬 Synthesis - Combining thoughts/branches (cyan)
+ * - 🧠 Meta - Metacognitive observation (gray)
+ * - 🔄 Revision - Thought that revises a previous thought (yellow)
+ * - 🌿 Branch - Thought that creates a new branch (green)
+ * @example
+ * ```typescript
+ * const formatter = new ThoughtFormatter();
+ *
+ * // Format a thought with recommendations
+ * const output = formatter.formatThought({
+ *   thought: 'I need to analyze the data structure',
+ *   thought_number: 1,
+ *   total_thoughts: 3,
+ *   next_thought_needed: true,
+ *   current_step: {
+ *     step_description: 'Analyze data structure',
+ *     recommended_tools: [{
+ *       tool_name: 'Read',
+ *       confidence: 0.95,
+ *       rationale: 'Direct file reading',
+ *       priority: 1,
+ *       suggested_inputs: { file_path: './data/schema.json' }
+ *     }],
+ *     expected_outcome: 'Understanding of data schema'
+ *   }
+ * });
+ *
+ * console.log(output);
+ * ```
+ */
+export declare class ThoughtFormatter implements IThoughtFormatter {
+    /**
+     * Formats a step recommendation into a readable string.
+     *
+     * Creates a structured display of the step description, recommended tools,
+     * recommended skills, expected outcome, and conditions for the next step.
+     *
+     * @param step - The step recommendation to format
+     * @returns A formatted string representation of the recommendation
+     *
+     * @example
+     * ```typescript
+     * const step: StepRecommendation = {
+     *   step_description: 'Search for API endpoints',
+     *   recommended_tools: [{
+     *     tool_name: 'Grep',
+     *     confidence: 0.9,
+     *     rationale: 'Best for searching code patterns',
+     *     priority: 1,
+     *     suggested_inputs: { pattern: 'export.*function' }
+     *   }],
+     *   expected_outcome: 'List of all exported API functions',
+     *   next_step_conditions: ['If no results, try broader pattern']
+     * };
+     *
+     * const formatted = formatter.formatRecommendation(step);
+     * console.log(formatted);
+     * ```
+     */
+    formatRecommendation(step: StepRecommendation): string;
+    /**
+     * Formats a thought into a clean, simple display.
+     *
+     * Creates a clean output containing the thought content with an appropriate
+     * header indicating the thought type. Priority order for icon selection:
+     * `is_revision` > `branch_from_thought` > `thought_type`.
+     *
+     * Supported `thought_type` icons:
+     * - `'regular'` (or undefined): 💭 blue "Thought" (default)
+     * - `'hypothesis'`: 🔬 magenta "Hypothesis"
+     * - `'verification'`: ✅ green "Verification"
+     * - `'critique'`: 🔍 red "Critique"
+     * - `'synthesis'`: 🧬 cyan "Synthesis"
+     * - `'meta'`: 🧠 gray "Meta"
+     *
+     * @param thoughtData - The thought data to format
+     * @returns A formatted string with thought and recommendations
+     *
+     * @example
+     * ```typescript
+     * // Regular thought
+     * const regular = formatter.formatThought({
+     *   thought: 'I should read the configuration file',
+     *   thought_number: 1,
+     *   total_thoughts: 3,
+     *   next_thought_needed: true
+     * });
+     * // Output: 💭 Thought 1/3: I should read the configuration file
+     *
+     * // With recommendation
+     * const withRec = formatter.formatThought({
+     *   thought: 'I need to search the codebase',
+     *   thought_number: 1,
+     *   total_thoughts: 3,
+     *   next_thought_needed: true,
+     *   current_step: {
+     *     step_description: 'Search for files',
+     *     recommended_tools: [{ tool_name: 'Grep', priority: 1 }],
+     *     expected_outcome: 'List of matching files'
+     *   }
+     * });
+     * // Output:
+     * // 💭 Thought 1/3: I need to search the codebase
+     * //   → Tools: Grep | List of matching files
+     * ```
+     */
+    formatThought(thoughtData: ThoughtData): string;
+}
+//# sourceMappingURL=ThoughtFormatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThoughtFormatter.d.ts","sourceRoot":"","sources":["../../src/core/ThoughtFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACzD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACI,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM;IAuB7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACI,aAAa,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM;CAsCtD"}

package/dist/core/ThoughtFormatter.js

@@ -0,0 +1,118 @@
+import chalk from "chalk";
+import { assertNever } from "../utils.js";
+class ThoughtFormatter {
+    formatRecommendation(step) {
+        const parts = [];
+        if (step.recommended_tools?.length) {
+            const toolNames = step.recommended_tools.map((t)=>t.tool_name).join(', ');
+            parts.push(chalk.cyan(`Tools: ${toolNames}`));
+        }
+        if (step.recommended_skills?.length) {
+            const skillNames = step.recommended_skills.map((s)=>s.skill_name).join(', ');
+            parts.push(chalk.green(`Skills: ${skillNames}`));
+        }
+        if (step.expected_outcome) parts.push(chalk.gray(`→ ${step.expected_outcome}`));
+        return parts.join(' | ');
+    }
+    formatThought(thoughtData) {
+        const { thought_number, total_thoughts, thought, current_step } = thoughtData;
+        const { icon, label, suffix } = resolveThoughtDisplay(thoughtData);
+        const retractedTag = thoughtData.retracted ? chalk.red.strikethrough('[RETRACTED] ') : '';
+        const header = `${icon} ${label} ${thought_number}/${total_thoughts}${suffix}: ${retractedTag}`;
+        const lines = [];
+        lines.push(`${header}${thought}`);
+        if (current_step) {
+            const recommendation = this.formatRecommendation(current_step);
+            lines.push(`  ${recommendation}`);
+        }
+        if (thoughtData.id) lines.push(`  ${chalk.gray(`🆔 ${thoughtData.id}`)}`);
+        if (thoughtData.meta_observation) lines.push(`  ${chalk.gray(`📝 ${thoughtData.meta_observation}`)}`);
+        return lines.join('\n');
+    }
+}
+function resolveThoughtDisplay(thoughtData) {
+    if (thoughtData.is_revision) return {
+        icon: chalk.yellow('🔄'),
+        label: 'Revision',
+        suffix: chalk.gray(` (revise #${thoughtData.revises_thought})`)
+    };
+    if (thoughtData.branch_from_thought) return {
+        icon: chalk.green('🌿'),
+        label: 'Branch',
+        suffix: chalk.gray(` (from #${thoughtData.branch_from_thought})`)
+    };
+    const thoughtType = thoughtData.thought_type ?? 'regular';
+    switch(thoughtType){
+        case 'hypothesis':
+            return {
+                icon: chalk.magenta('🔬'),
+                label: 'Hypothesis',
+                suffix: ''
+            };
+        case 'verification':
+            return {
+                icon: chalk.green('✅'),
+                label: 'Verification',
+                suffix: ''
+            };
+        case 'critique':
+            return {
+                icon: chalk.red('🔍'),
+                label: 'Critique',
+                suffix: ''
+            };
+        case 'synthesis':
+            return {
+                icon: chalk.cyan('🧬'),
+                label: 'Synthesis',
+                suffix: ''
+            };
+        case 'meta':
+            return {
+                icon: chalk.gray('🧠'),
+                label: 'Meta',
+                suffix: ''
+            };
+        case 'tool_call':
+            return {
+                icon: chalk.yellow('🔧'),
+                label: 'Tool Call',
+                suffix: ''
+            };
+        case 'tool_observation':
+            return {
+                icon: chalk.yellow('👁️'),
+                label: 'Tool Observation',
+                suffix: ''
+            };
+        case 'assumption':
+            return {
+                icon: chalk.yellow('💡'),
+                label: 'Assumption',
+                suffix: ''
+            };
+        case 'decomposition':
+            return {
+                icon: chalk.cyan('🧩'),
+                label: 'Decomposition',
+                suffix: ''
+            };
+        case 'backtrack':
+            return {
+                icon: chalk.red('↩️'),
+                label: 'Backtrack',
+                suffix: ''
+            };
+        case 'regular':
+            return {
+                icon: chalk.blue('💭'),
+                label: 'Thought',
+                suffix: ''
+            };
+        default:
+            assertNever(thoughtType);
+    }
+}
+export { ThoughtFormatter };
+
+//# sourceMappingURL=ThoughtFormatter.js.map

package/dist/core/ThoughtFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/ThoughtFormatter.js","sources":["../../src/core/ThoughtFormatter.ts"],"sourcesContent":["/**\n * Display formatting for thoughts and recommendations.\n *\n * This module provides the `ThoughtFormatter` class which handles all\n * presentation logic for thought data, including clean, simple output\n * formatting and structured display of tool/skill recommendations.\n *\n * @module formatter\n */\n\nimport chalk from 'chalk';\nimport type { IThoughtFormatter } from './IThoughtFormatter.js';\nimport type { ThoughtType } from './reasoning.js';\nimport type { StepRecommendation } from './step.js';\nimport type { ThoughtData } from './thought.js';\nimport { assertNever } from '../utils.js';\n\ntype ThoughtDisplay = {\n\treadonly icon: string;\n\treadonly label: string;\n\treadonly suffix: string;\n};\n\n/**\n * Formatter for thought data and step recommendations.\n *\n * This class separates presentation concerns from business logic, providing\n * clean, readable output for thoughts with structured display of\n * tool and skill recommendations.\n *\n * @remarks\n * Output Format is clean and simple:\n * - 💭 Thought - Regular thought (blue)\n * - 🔬 Hypothesis - Proposed explanation (magenta)\n * - ✅ Verification - Testing a hypothesis (green)\n * - 🔍 Critique - Self-critique of reasoning (red)\n * - 🧬 Synthesis - Combining thoughts/branches (cyan)\n * - 🧠 Meta - Metacognitive observation (gray)\n * - 🔄 Revision - Thought that revises a previous thought (yellow)\n * - 🌿 Branch - Thought that creates a new branch (green)\n * @example\n * ```typescript\n * const formatter = new ThoughtFormatter();\n *\n * // Format a thought with recommendations\n * const output = formatter.formatThought({\n *   thought: 'I need to analyze the data structure',\n *   thought_number: 1,\n *   total_thoughts: 3,\n *   next_thought_needed: true,\n *   current_step: {\n *     step_description: 'Analyze data structure',\n *     recommended_tools: [{\n *       tool_name: 'Read',\n *       confidence: 0.95,\n *       rationale: 'Direct file reading',\n *       priority: 1,\n *       suggested_inputs: { file_path: './data/schema.json' }\n *     }],\n *     expected_outcome: 'Understanding of data schema'\n *   }\n * });\n *\n * console.log(output);\n * ```\n */\nexport class ThoughtFormatter implements IThoughtFormatter {\n\t/**\n\t * Formats a step recommendation into a readable string.\n\t *\n\t * Creates a structured display of the step description, recommended tools,\n\t * recommended skills, expected outcome, and conditions for the next step.\n\t *\n\t * @param step - The step recommendation to format\n\t * @returns A formatted string representation of the recommendation\n\t *\n\t * @example\n\t * ```typescript\n\t * const step: StepRecommendation = {\n\t *   step_description: 'Search for API endpoints',\n\t *   recommended_tools: [{\n\t *     tool_name: 'Grep',\n\t *     confidence: 0.9,\n\t *     rationale: 'Best for searching code patterns',\n\t *     priority: 1,\n\t *     suggested_inputs: { pattern: 'export.*function' }\n\t *   }],\n\t *   expected_outcome: 'List of all exported API functions',\n\t *   next_step_conditions: ['If no results, try broader pattern']\n\t * };\n\t *\n\t * const formatted = formatter.formatRecommendation(step);\n\t * console.log(formatted);\n\t * ```\n\t */\n\tpublic formatRecommendation(step: StepRecommendation): string {\n\t\tconst parts: string[] = [];\n\n\t\t// Add tools if present\n\t\tif (step.recommended_tools?.length) {\n\t\t\tconst toolNames = step.recommended_tools.map((t) => t.tool_name).join(', ');\n\t\t\tparts.push(chalk.cyan(`Tools: ${toolNames}`));\n\t\t}\n\n\t\t// Add skills if present\n\t\tif (step.recommended_skills?.length) {\n\t\t\tconst skillNames = step.recommended_skills.map((s) => s.skill_name).join(', ');\n\t\t\tparts.push(chalk.green(`Skills: ${skillNames}`));\n\t\t}\n\n\t\t// Add expected outcome\n\t\tif (step.expected_outcome) {\n\t\t\tparts.push(chalk.gray(`→ ${step.expected_outcome}`));\n\t\t}\n\n\t\treturn parts.join(' | ');\n\t}\n\n\t/**\n\t * Formats a thought into a clean, simple display.\n\t *\n\t * Creates a clean output containing the thought content with an appropriate\n\t * header indicating the thought type. Priority order for icon selection:\n\t * `is_revision` > `branch_from_thought` > `thought_type`.\n\t *\n\t * Supported `thought_type` icons:\n\t * - `'regular'` (or undefined): 💭 blue \"Thought\" (default)\n\t * - `'hypothesis'`: 🔬 magenta \"Hypothesis\"\n\t * - `'verification'`: ✅ green \"Verification\"\n\t * - `'critique'`: 🔍 red \"Critique\"\n\t * - `'synthesis'`: 🧬 cyan \"Synthesis\"\n\t * - `'meta'`: 🧠 gray \"Meta\"\n\t *\n\t * @param thoughtData - The thought data to format\n\t * @returns A formatted string with thought and recommendations\n\t *\n\t * @example\n\t * ```typescript\n\t * // Regular thought\n\t * const regular = formatter.formatThought({\n\t *   thought: 'I should read the configuration file',\n\t *   thought_number: 1,\n\t *   total_thoughts: 3,\n\t *   next_thought_needed: true\n\t * });\n\t * // Output: 💭 Thought 1/3: I should read the configuration file\n\t *\n\t * // With recommendation\n\t * const withRec = formatter.formatThought({\n\t *   thought: 'I need to search the codebase',\n\t *   thought_number: 1,\n\t *   total_thoughts: 3,\n\t *   next_thought_needed: true,\n\t *   current_step: {\n\t *     step_description: 'Search for files',\n\t *     recommended_tools: [{ tool_name: 'Grep', priority: 1 }],\n\t *     expected_outcome: 'List of matching files'\n\t *   }\n\t * });\n\t * // Output:\n\t * // 💭 Thought 1/3: I need to search the codebase\n\t * //   → Tools: Grep | List of matching files\n\t * ```\n\t */\n\tpublic formatThought(thoughtData: ThoughtData): string {\n\t\tconst {\n\t\t\tthought_number,\n\t\t\ttotal_thoughts,\n\t\t\tthought,\n\t\t\tcurrent_step,\n\t\t} = thoughtData;\n\n\t\tconst { icon, label, suffix } = resolveThoughtDisplay(thoughtData);\n\n\t\t// Build header: \"💭 Thought 1/3: \"\n\t\tconst retractedTag = thoughtData.retracted ? chalk.red.strikethrough('[RETRACTED] ') : '';\n\t\tconst header = `${icon} ${label} ${thought_number}/${total_thoughts}${suffix}: ${retractedTag}`;\n\n\t\t// Build content lines\n\t\tconst lines: string[] = [];\n\n\t\t// Add the thought content\n\t\tlines.push(`${header}${thought}`);\n\n\t\t// Add recommendation if present\n\t\tif (current_step) {\n\t\t\tconst recommendation = this.formatRecommendation(current_step);\n\t\t\tlines.push(`  ${recommendation}`);\n\t\t}\n\n\t\t// Add id if present (for DAG debugging)\n\t\tif (thoughtData.id) {\n\t\t\tlines.push(`  ${chalk.gray(`🆔 ${thoughtData.id}`)}`);\n\t\t}\n\n\t\t// Add meta observation if present\n\t\tif (thoughtData.meta_observation) {\n\t\t\tlines.push(`  ${chalk.gray(`📝 ${thoughtData.meta_observation}`)}`);\n\t\t}\n\n\t\treturn lines.join('\\n');\n\t}\n}\n\nfunction resolveThoughtDisplay(thoughtData: ThoughtData): ThoughtDisplay {\n\tif (thoughtData.is_revision) {\n\t\treturn {\n\t\t\ticon: chalk.yellow('🔄'),\n\t\t\tlabel: 'Revision',\n\t\t\tsuffix: chalk.gray(` (revise #${thoughtData.revises_thought})`),\n\t\t};\n\t}\n\n\tif (thoughtData.branch_from_thought) {\n\t\treturn {\n\t\t\ticon: chalk.green('🌿'),\n\t\t\tlabel: 'Branch',\n\t\t\tsuffix: chalk.gray(` (from #${thoughtData.branch_from_thought})`),\n\t\t};\n\t}\n\n\tconst thoughtType: ThoughtType = thoughtData.thought_type ?? 'regular';\n\tswitch (thoughtType) {\n\t\tcase 'hypothesis':\n\t\t\treturn { icon: chalk.magenta('🔬'), label: 'Hypothesis', suffix: '' };\n\t\tcase 'verification':\n\t\t\treturn { icon: chalk.green('✅'), label: 'Verification', suffix: '' };\n\t\tcase 'critique':\n\t\t\treturn { icon: chalk.red('🔍'), label: 'Critique', suffix: '' };\n\t\tcase 'synthesis':\n\t\t\treturn { icon: chalk.cyan('🧬'), label: 'Synthesis', suffix: '' };\n\t\tcase 'meta':\n\t\t\treturn { icon: chalk.gray('🧠'), label: 'Meta', suffix: '' };\n\t\tcase 'tool_call':\n\t\t\treturn { icon: chalk.yellow('🔧'), label: 'Tool Call', suffix: '' };\n\t\tcase 'tool_observation':\n\t\t\treturn { icon: chalk.yellow('👁️'), label: 'Tool Observation', suffix: '' };\n\t\tcase 'assumption':\n\t\t\treturn { icon: chalk.yellow('💡'), label: 'Assumption', suffix: '' };\n\t\tcase 'decomposition':\n\t\t\treturn { icon: chalk.cyan('🧩'), label: 'Decomposition', suffix: '' };\n\t\tcase 'backtrack':\n\t\t\treturn { icon: chalk.red('↩️'), label: 'Backtrack', suffix: '' };\n\t\tcase 'regular':\n\t\t\treturn { icon: chalk.blue('💭'), label: 'Thought', suffix: '' };\n\t\tdefault:\n\t\t\tassertNever(thoughtType);\n\t}\n}\n"],"names":["ThoughtFormatter","step","parts","toolNames","t","chalk","skillNames","s","thoughtData","thought_number","total_thoughts","thought","current_step","icon","label","suffix","resolveThoughtDisplay","retractedTag","header","lines","recommendation","thoughtType","assertNever"],"mappings":"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"}