@iworkforces/tracelattice 2.0.3

package/dist/core/HistoryManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/HistoryManager.js","sources":["../../src/core/HistoryManager.ts"],"sourcesContent":["/**\n * History and branch management for sequential thinking.\n *\n * This module provides the `HistoryManager` class which manages thought history,\n * branching, and optional persistence with per-session state isolation.\n *\n * Internally delegates to three focused collaborators:\n * - `EdgeEmitter` — DAG edge emission\n * - `PersistenceBuffer` — buffered persistence + retry/backoff\n * - `SessionManager` — session lifecycle (TTL/LRU eviction)\n *\n * @module HistoryManager\n */\n\nimport type { IEdgeStore, IMetrics, ISessionLock } from '../contracts/interfaces.js';\nimport {\n\tasSessionId,\n\tGLOBAL_SESSION_ID,\n\ttype BranchId,\n\ttype SessionId,\n\ttype ThoughtId,\n} from '../contracts/ids.js';\nimport type { ISummaryStore } from '../contracts/summary.js';\nimport {\n\tInvalidBacktrackError,\n\tMaxSessionsReachedError,\n\tValidationError,\n} from '../errors.js';\nimport { NullLogger } from '../logger/NullLogger.js';\nimport type { Logger } from '../logger/StructuredLogger.js';\nimport type { PersistenceBackend } from '../contracts/PersistenceBackend.js';\nimport {\n\tDehydrationPolicy,\n\ttype DehydrationOptions,\n\ttype HydratedEntry,\n} from './compression/DehydrationPolicy.js';\nimport type { Summary } from './compression/Summary.js';\nimport { AsyncResetRequiredError, SessionAccessDeniedError } from './SessionErrors.js';\nimport { EdgeEmitter } from './graph/EdgeEmitter.js';\nimport type {\n\tHistorySessionSnapshot,\n\tIHistoryManager,\n\tThoughtAdmissionContext,\n} from './IHistoryManager.js';\nimport { PersistenceBuffer, type PersistenceEventEmitter } from './PersistenceBuffer.js';\nimport { SessionManager } from './SessionManager.js';\nimport { SessionResetCoordinator } from './SessionResetCoordinator.js';\nimport { stagePersistenceRestore, type RestoredSession } from './PersistenceRestore.js';\nimport type { ThoughtData } from './thought.js';\nimport { getOwner } from '../context/RequestContext.js';\nimport { ThoughtReferenceIndex, type ThoughtReferenceResolution } from './ThoughtReferenceIndex.js';\nimport { resolveThoughtReferencesForAdmission } from './CrossReferenceValidator.js';\nimport { SessionLifecycleCoordinator } from './SessionLifecycleCoordinator.js';\n\n/** Absolute maximum history size (~20MB at 2KB/thought). Cannot be overridden. */\nexport const ABSOLUTE_MAX_HISTORY_SIZE = 10_000;\n\ninterface SessionState {\n\tthought_history: ThoughtData[];\n\tbranches: Record<string, ThoughtData[]>;\n\tavailableMcpTools: string[] | undefined;\n\tavailableSkills: string[] | undefined;\n\twriteBuffer: ThoughtData[];\n\tlastAccessedAt: number;\n\tbranchIdentities: Set<BranchId>;\n\tpendingRestoreBranchDeletes: Set<BranchId>;\n\t/** Owner identifier set on first owner-aware access. Immutable thereafter. */\n\towner?: string;\n\t/** Non-persisted startup provenance used to block unverified network ownership. */\n\tprovenance?: 'restored';\n}\n\nexport interface HistoryManagerConfig {\n\t/** Maximum number of thoughts to keep in main history. @default 1000 */\n\tmaxHistorySize?: number;\n\t/** Maximum number of branches to maintain. @default 50 */\n\tmaxBranches?: number;\n\t/** Maximum size of each branch. @default 100 */\n\tmaxBranchSize?: number;\n\tlogger?: Logger;\n\tpersistence?: PersistenceBackend | null;\n\tmetrics?: IMetrics;\n\t/** Maximum number of thoughts to buffer before flushing. @default 100 */\n\tpersistenceBufferSize?: number;\n\t/** Periodic flush interval in ms. @default 1000 */\n\tpersistenceFlushInterval?: number;\n\t/** Max retries for failed persistence flushes. @default 3 */\n\tpersistenceMaxRetries?: number;\n\teventEmitter?: PersistenceEventEmitter;\n\tedgeStore?: IEdgeStore;\n\tsummaryStore?: ISummaryStore;\n\t/** Whether to emit DAG edges (gated independently of edgeStore). @default false */\n\tdagEdges?: boolean;\n\t/** Maximum sessions per owner (per-owner LRU bucket). @default 50 */\n\tmaxSessionsPerOwner?: number;\n\t/** Shared processor lock used to reject unsafe legacy synchronous clears. */\n\tsessionLock?: ISessionLock;\n\t/** Shared admission and exclusive lifecycle coordinator. */\n\tlifecycleCoordinator?: SessionLifecycleCoordinator;\n\t/** Clears processor-owned state after a session is actually removed. */\n\tclearSessionAuxiliaryState?: (sessionId: SessionId) => void;\n\t/** Clears all processor-owned state after a successful global lifecycle operation. */\n\tclearAllAuxiliaryState?: () => void;\n}\n\n/**\n * Manages thought history and branching for sequential thinking.\n *\n * Owns the per-session `Map<string, SessionState>`. Delegates DAG edge emission,\n * buffered persistence, and session TTL/LRU eviction to focused collaborators while\n * preserving test-coupled private member names (`_flushTimer`, `_startFlushTimer`,\n * `_flushBuffer`, `_sessions`).\n */\nexport class HistoryManager implements IHistoryManager {\n\tprivate static readonly DEFAULT_SESSION = GLOBAL_SESSION_ID;\n\tprivate static readonly SESSION_TTL_MS = 30 * 60 * 1000;\n\tprivate static readonly MAX_SESSIONS = 100;\n\tprivate _sessions: Map<SessionId, SessionState> = new Map();\n\tprivate _maxHistorySize: number;\n\tprivate _maxBranches: number;\n\tprivate _maxBranchSize: number;\n\tprivate _logger: Logger;\n\tprivate _persistence: PersistenceBackend | null;\n\tprivate _persistenceEnabled: boolean;\n\tprivate _metrics?: IMetrics;\n\n\tprivate _edgeStore?: IEdgeStore;\n\tprivate _summaryStore?: ISummaryStore;\n\tprivate _dagEdges: boolean;\n\n\tprivate _eventEmitter: PersistenceEventEmitter | null;\n\n\tprivate readonly _edgeEmitter: EdgeEmitter;\n\tprivate _referenceIndex = new ThoughtReferenceIndex();\n\tprivate _persistenceBuffer: PersistenceBuffer<SessionState> | null;\n\tprivate readonly _sessionManager: SessionManager<SessionState>;\n\tprivate readonly _resetCoordinator: SessionResetCoordinator<SessionState>;\n\tprivate readonly _sessionLock?: ISessionLock;\n\tprivate readonly _lifecycle: SessionLifecycleCoordinator;\n\tprivate _shutdownOwner: (() => Promise<void>) | null = null;\n\tprivate readonly _clearSessionAuxiliaryState?: (sessionId: SessionId) => void;\n\tprivate readonly _clearAllAuxiliaryState?: () => void;\n\n\tconstructor(config: HistoryManagerConfig = {}) {\n\t\tthis._logger = config.logger ?? new NullLogger();\n\t\tconst requestedMaxSize = config.maxHistorySize ?? 10000;\n\t\tthis._maxHistorySize = Math.min(requestedMaxSize, ABSOLUTE_MAX_HISTORY_SIZE);\n\t\tif (requestedMaxSize > ABSOLUTE_MAX_HISTORY_SIZE) {\n\t\t\tthis._logger.warn('maxHistorySize exceeds absolute maximum, capped', {\n\t\t\t\trequested: requestedMaxSize,\n\t\t\t\tapplied: ABSOLUTE_MAX_HISTORY_SIZE,\n\t\t\t});\n\t\t}\n\t\tthis._maxBranches = config.maxBranches ?? 50;\n\t\tthis._maxBranchSize = config.maxBranchSize || 100;\n\t\tthis._persistence = config.persistence ?? null;\n\t\tthis._persistenceEnabled = this._persistence !== null;\n\t\tthis._metrics = config.metrics;\n\t\tthis._eventEmitter = config.eventEmitter ?? null;\n\t\tthis._edgeStore = config.edgeStore;\n\t\tthis._summaryStore = config.summaryStore;\n\t\tthis._dagEdges = config.dagEdges ?? true;\n\t\tthis._sessionLock = config.sessionLock;\n\t\tthis._lifecycle = config.lifecycleCoordinator ?? new SessionLifecycleCoordinator();\n\t\tthis._clearSessionAuxiliaryState = config.clearSessionAuxiliaryState;\n\t\tthis._clearAllAuxiliaryState = config.clearAllAuxiliaryState;\n\n\t\t// Wire delegates\n\t\tthis._edgeEmitter = new EdgeEmitter({\n\t\t\tedgeStore: this._edgeStore,\n\t\t\tdagEdges: this._dagEdges,\n\t\t\tdefaultSessionId: HistoryManager.DEFAULT_SESSION,\n\t\t\tlogger: this._logger,\n\t\t});\n\n\t\tthis._sessionManager = new SessionManager<SessionState>({\n\t\t\tdefaultSessionId: HistoryManager.DEFAULT_SESSION,\n\t\t\tsessionTtlMs: HistoryManager.SESSION_TTL_MS,\n\t\t\tcleanupIntervalMs: 5 * 60 * 1000,\n\t\t\tgetMaxSessions: () => HistoryManager.MAX_SESSIONS,\n\t\t\tmaxSessionsPerOwner: config.maxSessionsPerOwner ?? 50,\n\t\t\tlogger: this._logger,\n\t\t});\n\n\t\tthis._persistenceBuffer = null;\n\t\tif (this._persistenceEnabled && this._persistence) {\n\t\t\tthis._persistenceBuffer = new PersistenceBuffer<SessionState>({\n\t\t\t\tpersistence: this._persistence,\n\t\t\t\tbufferSize: config.persistenceBufferSize ?? 100,\n\t\t\t\tflushInterval: config.persistenceFlushInterval ?? 1000,\n\t\t\t\tmaxRetries: config.persistenceMaxRetries ?? 3,\n\t\t\t\tdefaultSessionId: asSessionId(HistoryManager.DEFAULT_SESSION),\n\t\t\t\tgetSessions: () => this._sessions,\n\t\t\t\tgetDefaultSession: () => this._getSession(),\n\t\t\t\tedgeStore: this._edgeStore,\n\t\t\t\teventEmitter: this._eventEmitter,\n\t\t\t\tlogger: this._logger,\n\t\t\t});\n\t\t\tthis._startFlushTimer();\n\t\t}\n\t\tthis._resetCoordinator = new SessionResetCoordinator({\n\t\t\tpersistence: this._persistence,\n\t\t\tbarrier: this._persistenceBuffer,\n\t\t\tedgeStore: this._edgeStore,\n\t\t\tsummaryStore: this._summaryStore,\n\t\t\tsessions: this._sessions,\n\t\t\tcreateSessionState: (owner) => this._createSessionState(owner),\n\t\t\tlogger: this._logger,\n\t\t});\n\n\t\tthis._sessionManager.startCleanupTimer(\n\t\t\tthis._sessions,\n\t\t\t(sessionId) => this._isTtlEvictionEligible(sessionId),\n\t\t\t(sessionIds) => this._evictSessions(sessionIds)\n\t\t);\n\t}\n\n\t// Test-coupled accessors: these private member names must remain reachable\n\t// via `manager as unknown as { _flushTimer; _startFlushTimer }`.\n\tprivate get _flushTimer(): ReturnType<typeof setInterval> | null {\n\t\treturn this._persistenceBuffer?.timer ?? null;\n\t}\n\n\tprivate _startFlushTimer(): void {\n\t\tthis._persistenceBuffer?.startFlushTimer();\n\t}\n\n\tprivate _stopFlushTimer(): void {\n\t\tif (this._flushTimer === null) return;\n\t\tthis._persistenceBuffer?.stopFlushTimer();\n\t}\n\n\t/** @internal Public for backward-compatible test coupling. */\n\tpublic _flushBuffer(): Promise<void> {\n\t\tthis._stageAllRestoreBranchReconciliation();\n\t\treturn this._persistenceBuffer?.flush() ?? Promise.resolve();\n\t}\n\n\t/**\n\t * Drains accepted persistence work and projects terminal failures to one session.\n\t *\n\t * @param sessionId - Authoritative session whose persistence barrier to await.\n\t * @returns A promise that settles when the session's accepted work settles.\n\t */\n\tpublic drainSession(sessionId: SessionId): Promise<void> {\n\t\tconst session = this._sessions.get(sessionId);\n\t\tif (session !== undefined) this._stageRestoreBranchReconciliation(sessionId, session);\n\t\treturn this._persistenceBuffer?.drainSession(sessionId) ?? Promise.resolve();\n\t}\n\n\t/**\n\t * Registers the latest summary snapshot for coordinator-owned persistence.\n\t *\n\t * @param sessionId - Authoritative session that owns the summaries.\n\t * @param summaries - Complete current summary snapshot for the session.\n\t */\n\tpublic bufferSummaries(sessionId: SessionId, summaries: readonly Summary[]): void {\n\t\tthis._lifecycle.runMutation(sessionId, () => {\n\t\t\tthis._persistenceBuffer?.bufferSummaries(sessionId, summaries);\n\t\t\tconst session = this._sessions.get(sessionId);\n\t\t\tif (session !== undefined) this._stageRestoreBranchReconciliation(sessionId, session);\n\t\t});\n\t}\n\n\t/** EdgeStore instance, if configured. Used by ThoughtProcessor for StrategyContext. */\n\tpublic getEdgeStore(): IEdgeStore | undefined {\n\t\treturn this._edgeStore;\n\t}\n\n\tprivate log(message: string, meta?: Record<string, unknown>): void {\n\t\tthis._logger.info(message, meta);\n\t}\n\n\t/** Reads owner from RequestContext (AsyncLocalStorage). Stdio path returns undefined. */\n\tprivate _getCurrentOwner(): string | undefined {\n\t\treturn getOwner();\n\t}\n\n\t/**\n\t * Gets or creates session state; updates lastAccessedAt.\n\t *\n\t * Ownership semantics:\n\t * - `owner === undefined` (stdio path): never rejects, never sets owner.\n\t * - `owner !== undefined`: if session has a different owner, throws\n\t *   `SessionAccessDeniedError`. If session was created without an owner\n\t *   (e.g. by stdio), the owner is set on first owner-aware access.\n\t */\n\tprivate _getSession(sessionId?: string, owner?: string): SessionState {\n\t\tconst key = sessionId === undefined ? HistoryManager.DEFAULT_SESSION : asSessionId(sessionId);\n\t\tconst existing = this._sessions.get(key);\n\t\tif (existing !== undefined) {\n\t\t\tthis._assertSessionOwner(key, existing, owner);\n\t\t\texisting.lastAccessedAt = Date.now();\n\t\t\treturn existing;\n\t\t}\n\t\treturn this._lifecycle.runMutation(key, () => this._getSessionWithinOperation(key, owner));\n\t}\n\n\tprivate _getSessionWithinOperation(key: SessionId, owner?: string): SessionState {\n\t\tlet session = this._sessions.get(key);\n\t\tif (!session) {\n\t\t\tthis._makeCapacityForSession(owner);\n\t\t\tsession = this._createSessionState(owner);\n\t\t\tthis._sessions.set(key, session);\n\t\t} else {\n\t\t\tthis._assertSessionOwner(key, session, owner);\n\t\t}\n\t\tsession.lastAccessedAt = Date.now();\n\t\treturn session;\n\t}\n\n\tprivate _assertSessionOwner(\n\t\tsessionId: SessionId,\n\t\tsession: SessionState,\n\t\towner: string | undefined\n\t): void {\n\t\tif (owner === undefined) return;\n\t\tif (session.provenance === 'restored') {\n\t\t\tthrow new SessionAccessDeniedError(sessionId, 'unavailable', owner);\n\t\t}\n\t\tif (session.owner !== undefined && session.owner !== owner) {\n\t\t\tthrow new SessionAccessDeniedError(sessionId, session.owner, owner);\n\t\t}\n\t\tif (session.owner === undefined) session.owner = owner;\n\t}\n\n\tprivate _makeCapacityForSession(owner: string | undefined): void {\n\t\tconst victims = this._sessionManager.planProspectiveAdmission(\n\t\t\tthis._sessions,\n\t\t\towner,\n\t\t\t(sessionId) => this._isCapacityEvictionEligible(sessionId)\n\t\t);\n\t\tif (victims === undefined) throw new MaxSessionsReachedError(HistoryManager.MAX_SESSIONS);\n\t\tif (victims.length === 0) return;\n\t\tconst evicted = this._lifecycle.tryEvictIdleSessions(victims, (sessionIds) => {\n\t\t\tif (sessionIds.some((sessionId) => !this._isPersistenceQuiescent(sessionId))) {\n\t\t\t\tthrow new MaxSessionsReachedError(HistoryManager.MAX_SESSIONS);\n\t\t\t}\n\t\t\tfor (const sessionId of sessionIds) this._removeLiveSession(sessionId);\n\t\t});\n\t\tif (!evicted) throw new MaxSessionsReachedError(HistoryManager.MAX_SESSIONS);\n\t}\n\n\tprivate _isCapacityEvictionEligible(sessionId: SessionId): boolean {\n\t\treturn this._lifecycle.isIdle(sessionId) && this._isPersistenceQuiescent(sessionId);\n\t}\n\n\tprivate _isTtlEvictionEligible(sessionId: SessionId): boolean {\n\t\tconst persistenceState =\n\t\t\tthis._persistenceBuffer?.sessionEvictionState(sessionId) ?? 'quiescent';\n\t\treturn (\n\t\t\tthis._lifecycle.isIdle(sessionId) &&\n\t\t\tpersistenceState !== 'failed' &&\n\t\t\tpersistenceState !== 'barrier'\n\t\t);\n\t}\n\n\tprivate _isPersistenceQuiescent(sessionId: SessionId): boolean {\n\t\treturn (\n\t\t\t(this._persistenceBuffer?.sessionEvictionState(sessionId) ?? 'quiescent') === 'quiescent'\n\t\t);\n\t}\n\n\tprivate async _evictSessions(sessionIds: readonly SessionId[]): Promise<void> {\n\t\tconst results = await Promise.allSettled(\n\t\t\tsessionIds.map((sessionId) => this._evictSession(sessionId))\n\t\t);\n\t\tconst failures = results.flatMap((result) =>\n\t\t\tresult.status === 'rejected' ? [result.reason] : []\n\t\t);\n\t\tif (failures.length > 0) throw new AggregateError(failures, 'Session eviction failed');\n\t}\n\n\tprivate _evictSession(sessionId: SessionId): Promise<void> {\n\t\treturn this._lifecycle.withSessionEviction(sessionId, async () => {\n\t\t\tif (this._persistenceBuffer === null) {\n\t\t\t\tthis._removeLiveSession(sessionId);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst session = this._sessions.get(sessionId);\n\t\t\tif (session !== undefined) this._stageRestoreBranchReconciliation(sessionId, session);\n\t\t\tawait this._persistenceBuffer.withSessionEvictionBarrier(sessionId, async () => {\n\t\t\t\tthis._removeLiveSession(sessionId);\n\t\t\t});\n\t\t});\n\t}\n\n\tprivate _removeLiveSession(sessionId: SessionId): void {\n\t\tthis._clearSessionAuxiliaryState?.(sessionId);\n\t\tthis._edgeStore?.clearSession(sessionId);\n\t\tthis._summaryStore?.clearSession(sessionId);\n\t\tthis._referenceIndex.clearSession(sessionId);\n\t\tthis._sessions.delete(sessionId);\n\t\tthis._persistenceBuffer?.forgetQuiescentSession(sessionId);\n\t}\n\n\tprivate _createSessionState(owner?: string, provenance?: 'restored'): SessionState {\n\t\treturn {\n\t\t\tthought_history: [],\n\t\t\tbranches: {},\n\t\t\tavailableMcpTools: undefined,\n\t\t\tavailableSkills: undefined,\n\t\t\twriteBuffer: [],\n\t\t\tlastAccessedAt: Date.now(),\n\t\t\tbranchIdentities: new Set<BranchId>(),\n\t\t\tpendingRestoreBranchDeletes: new Set<BranchId>(),\n\t\t\towner,\n\t\t\tprovenance,\n\t\t};\n\t}\n\n\tprivate _authorizeExistingSession(\n\t\tsessionId: SessionId,\n\t\towner: string | undefined\n\t): string | undefined {\n\t\tconst sessionOwner = this._sessions.get(sessionId)?.owner;\n\t\tif (owner !== undefined && this._sessions.get(sessionId)?.provenance === 'restored') {\n\t\t\tthrow new SessionAccessDeniedError(sessionId, 'unavailable', owner);\n\t\t}\n\t\tif (owner !== undefined && sessionOwner !== undefined && sessionOwner !== owner) {\n\t\t\tthrow new SessionAccessDeniedError(sessionId, sessionOwner, owner);\n\t\t}\n\t\treturn sessionOwner ?? owner;\n\t}\n\n\tprivate _assertOwnerlessResetAll(): void {\n\t\tconst owner = this._getCurrentOwner();\n\t\tif (owner === undefined) return;\n\t\tconst firstSessionId = this._sessions.keys().next().value ?? HistoryManager.DEFAULT_SESSION;\n\t\tthrow new SessionAccessDeniedError(firstSessionId, 'trusted ownerless context', owner);\n\t}\n\n\t/**\n\t * Adds a thought to the history. Routes per-session, applies retraction for backtrack,\n\t * caches tools/skills, trims, branches, emits DAG edges, and buffers for persistence.\n\t */\n\tpublic addThought(thought: ThoughtData, context?: ThoughtAdmissionContext): void {\n\t\tconst sessionId = asSessionId(thought.session_id ?? HistoryManager.DEFAULT_SESSION);\n\t\tthis._lifecycle.runMutation(sessionId, () =>\n\t\t\tthis._addThoughtWithinOperation(sessionId, thought, context)\n\t\t);\n\t}\n\n\tprivate _addThoughtWithinOperation(\n\t\tsessionId: SessionId,\n\t\tthought: ThoughtData,\n\t\tcontext?: ThoughtAdmissionContext\n\t): void {\n\t\tthis._persistenceBuffer?.assertSessionAdmissionOpen(sessionId);\n\t\tconst owner = this._getCurrentOwner();\n\t\tthis._authorizeExistingSession(sessionId, owner);\n\t\tconst resolvedReferences = this._resolveAdmissionReferences(sessionId, thought, context);\n\t\tconst session = this._getSessionWithinOperation(sessionId, owner);\n\t\tthis._metrics?.counter(\n\t\t\t'thought_requests_total',\n\t\t\t1,\n\t\t\t{},\n\t\t\t'Total thought requests added to history'\n\t\t);\n\n\t\tsession.thought_history.push(thought);\n\n\t\t// Logical retraction: when a backtrack thought is added, mark its target\n\t\t// as retracted (append-only — target remains in history).\n\t\tif (resolvedReferences.backtrackTargetThoughtId !== undefined) {\n\t\t\tthis._applyRetraction(session, resolvedReferences.backtrackTargetThoughtId);\n\t\t}\n\n\t\t// Cache available_mcp_tools/available_skills for cross-call persistence\n\t\tif (thought.available_mcp_tools) {\n\t\t\tsession.availableMcpTools = thought.available_mcp_tools;\n\t\t}\n\t\tif (thought.available_skills) {\n\t\t\tsession.availableSkills = thought.available_skills;\n\t\t}\n\n\t\tif (thought.branch_from_thought && thought.branch_id) {\n\t\t\tthis._addToSessionBranch(session, thought.branch_id, thought);\n\t\t}\n\n\t\tif (thought.merge_from_thoughts?.length || thought.merge_branch_ids?.length) {\n\t\t\tthis._metrics?.counter(\n\t\t\t\t'thought_merge_operations_total',\n\t\t\t\t1,\n\t\t\t\t{},\n\t\t\t\t'Total merge operations (graph topology)'\n\t\t\t);\n\t\t}\n\n\t\tconst edgeAdded = this._edgeEmitter.emitEdgesForThought(session, thought, {\n\t\t\t...context,\n\t\t\tresolvedReferences,\n\t\t});\n\t\tconst evictedBranchIds = this._enforceRetention(session, thought.branch_id);\n\t\tthis._rebuildReferenceIndex(sessionId, session);\n\t\tconst prunedEdges = this._pruneUnretainedEdges(sessionId, session);\n\t\tthis._bufferRetainedState(\n\t\t\tsessionId,\n\t\t\tsession,\n\t\t\tthought,\n\t\t\tevictedBranchIds,\n\t\t\tedgeAdded,\n\t\t\tprunedEdges\n\t\t);\n\t}\n\n\tprivate _resolveAdmissionReferences(\n\t\tsessionId: SessionId,\n\t\tthought: ThoughtData,\n\t\tcontext?: ThoughtAdmissionContext\n\t): NonNullable<ThoughtAdmissionContext['resolvedReferences']> {\n\t\tconst resolved =\n\t\t\tcontext?.resolvedReferences ??\n\t\t\tresolveThoughtReferencesForAdmission(thought, (thoughtNumber) =>\n\t\t\t\tthis._referenceIndex.resolve(sessionId, thoughtNumber)\n\t\t\t);\n\t\tif (\n\t\t\tthought.thought_type === 'backtrack' &&\n\t\t\tthought.backtrack_target !== undefined &&\n\t\t\tresolved.backtrackTargetThoughtId === undefined\n\t\t) {\n\t\t\tthrow new InvalidBacktrackError(\n\t\t\t\t`backtrack_target ${thought.backtrack_target} is missing in session history`\n\t\t\t);\n\t\t}\n\t\treturn resolved;\n\t}\n\n\tprivate _enforceRetention(\n\t\tsession: SessionState,\n\t\tbranchId: BranchId | undefined\n\t): readonly BranchId[] {\n\t\tif (session.thought_history.length > this._maxHistorySize) {\n\t\t\tsession.thought_history = session.thought_history.slice(-this._maxHistorySize);\n\t\t\tthis.log(`History trimmed to ${this._maxHistorySize} items`, {\n\t\t\t\tmaxSize: this._maxHistorySize,\n\t\t\t});\n\t\t}\n\t\tif (branchId !== undefined) this._trimSessionBranchSize(session, branchId);\n\t\treturn this._cleanupSessionBranches(session);\n\t}\n\n\tprivate _pruneUnretainedEdges(sessionId: SessionId, session: SessionState): number {\n\t\tif (this._edgeStore === undefined) return 0;\n\t\tconst retainedIds = new Set<ThoughtId>();\n\t\tconst retainedBranchThoughtIds = new Set<ThoughtId>();\n\t\tfor (const thought of [session.thought_history, ...Object.values(session.branches)].flat()) {\n\t\t\tif (thought.id !== undefined) retainedIds.add(thought.id);\n\t\t}\n\t\tfor (const thought of Object.values(session.branches).flat()) {\n\t\t\tif (thought.id !== undefined) retainedBranchThoughtIds.add(thought.id);\n\t\t}\n\t\treturn this._edgeStore.pruneSession(sessionId, retainedIds, retainedBranchThoughtIds);\n\t}\n\n\tprivate _bufferRetainedState(\n\t\tsessionId: SessionId,\n\t\tsession: SessionState,\n\t\tthought: ThoughtData,\n\t\tevictedBranchIds: readonly BranchId[],\n\t\tedgeAdded: boolean,\n\t\tprunedEdges: number\n\t): void {\n\t\tconst buffer = this._persistenceBuffer;\n\t\tif (buffer === null) return;\n\t\tbuffer.bufferThought(sessionId, thought);\n\t\tif (\n\t\t\tthought.branch_id !== undefined ||\n\t\t\tevictedBranchIds.length > 0 ||\n\t\t\tsession.pendingRestoreBranchDeletes.size > 0\n\t\t) {\n\t\t\tthis._stageBranchPersistence(sessionId, session, evictedBranchIds);\n\t\t}\n\t\tif (this._edgeStore !== undefined && (edgeAdded || prunedEdges > 0)) {\n\t\t\tbuffer.bufferEdges(sessionId, this._edgeStore.edgesForSession(sessionId));\n\t\t}\n\t}\n\n\tprivate _stageAllRestoreBranchReconciliation(): void {\n\t\tfor (const [sessionId, session] of this._sessions) {\n\t\t\tthis._stageRestoreBranchReconciliation(sessionId, session);\n\t\t}\n\t}\n\n\tprivate _stageRestoreBranchReconciliation(sessionId: SessionId, session: SessionState): void {\n\t\tif (session.pendingRestoreBranchDeletes.size === 0) return;\n\t\tthis._stageBranchPersistence(sessionId, session, []);\n\t}\n\n\tprivate _stageBranchPersistence(\n\t\tsessionId: SessionId,\n\t\tsession: SessionState,\n\t\tordinaryDeletes: readonly BranchId[]\n\t): void {\n\t\tconst buffer = this._persistenceBuffer;\n\t\tif (buffer === null) return;\n\t\tfor (const branchId of session.branchIdentities) {\n\t\t\tconst branch = session.branches[branchId];\n\t\t\tif (branch !== undefined) buffer.bufferBranch(sessionId, branchId, branch);\n\t\t}\n\t\tconst branchIdsToDelete = new Set([...session.pendingRestoreBranchDeletes, ...ordinaryDeletes]);\n\t\tfor (const branchId of branchIdsToDelete) {\n\t\t\tif (session.branches[branchId] === undefined) buffer.deleteBranch(sessionId, branchId);\n\t\t}\n\t\tsession.pendingRestoreBranchDeletes.clear();\n\t}\n\n\t/** Marks the thought as retracted within the session (append-only). */\n\tprivate _applyRetraction(session: SessionState, targetId: ThoughtId): void {\n\t\tfor (const t of session.thought_history) {\n\t\t\tif (t.id === targetId) t.retracted = true;\n\t\t}\n\t\tfor (const branchThoughts of Object.values(session.branches)) {\n\t\t\tfor (const t of branchThoughts) {\n\t\t\t\tif (t.id === targetId) t.retracted = true;\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate _rebuildReferenceIndex(sessionId: SessionId, session: SessionState): void {\n\t\tconst retained = [session.thought_history, ...Object.values(session.branches)].flat();\n\t\tthis._referenceIndex.replaceSession(sessionId, retained);\n\t}\n\n\tpublic resolveThoughtReference(\n\t\tsessionId: SessionId,\n\t\tthoughtNumber: number\n\t): ThoughtReferenceResolution {\n\t\tthis._authorizeExistingSession(sessionId, this._getCurrentOwner());\n\t\treturn this._referenceIndex.resolve(sessionId, thoughtNumber);\n\t}\n\n\tprivate _addToSessionBranch(\n\t\tsession: SessionState,\n\t\tbranchId: BranchId,\n\t\tthought: ThoughtData\n\t): void {\n\t\tif (!session.branches[branchId]) {\n\t\t\tsession.branches[branchId] = [];\n\t\t}\n\t\tsession.branchIdentities.add(branchId);\n\t\tsession.branches[branchId].push(thought);\n\t}\n\n\tprivate _cleanupSessionBranches(session: SessionState): readonly BranchId[] {\n\t\tconst branchCount = session.branchIdentities.size;\n\t\tif (branchCount <= this._maxBranches) return [];\n\t\tconst identitiesToRemove = Array.from(session.branchIdentities).slice(\n\t\t\t0,\n\t\t\tbranchCount - this._maxBranches\n\t\t);\n\t\tconst branchesToDelete: BranchId[] = [];\n\t\tfor (const branchId of identitiesToRemove) {\n\t\t\tsession.branchIdentities.delete(branchId);\n\t\t\tif (session.branches[branchId] !== undefined) branchesToDelete.push(branchId);\n\t\t\tdelete session.branches[branchId];\n\t\t\tthis.log(`Removed old branch: ${branchId}`, { branchId });\n\t\t}\n\t\treturn branchesToDelete;\n\t}\n\n\tprivate _trimSessionBranchSize(session: SessionState, branchId: BranchId): void {\n\t\tconst branch = session.branches[branchId];\n\t\tif (branch !== undefined && branch.length > this._maxBranchSize) {\n\t\t\tconst removed = branch.length - this._maxBranchSize;\n\t\t\tsession.branches[branchId] = branch.slice(-this._maxBranchSize);\n\t\t\tthis.log(`Trimmed branch '${branchId}': removed ${removed} old thoughts`, {\n\t\t\t\tbranchId,\n\t\t\t\tremoved,\n\t\t\t});\n\t\t}\n\t}\n\n\tpublic getHistory(sessionId?: string): ThoughtData[] {\n\t\treturn this._getSession(sessionId, this._getCurrentOwner()).thought_history;\n\t}\n\n\t/**\n\t * Returns history with optional sliding-window dehydration. Non-mutating: when\n\t * `dagEdges` is off OR no `ISummaryStore` is configured, returns same as getHistory.\n\t */\n\tpublic getHistoryHydrated(sessionId?: string, opts?: DehydrationOptions): HydratedEntry[] {\n\t\tconst history = this.getHistory(sessionId);\n\t\tif (!this._dagEdges || !this._summaryStore) {\n\t\t\treturn history.slice();\n\t\t}\n\t\tconst sid = sessionId ?? HistoryManager.DEFAULT_SESSION;\n\t\tconst policy = new DehydrationPolicy(this._summaryStore);\n\t\treturn policy.apply(history, asSessionId(sid), opts);\n\t}\n\n\tpublic getHistoryLength(sessionId?: string): number {\n\t\treturn this._getSession(sessionId, this._getCurrentOwner()).thought_history.length;\n\t}\n\n\tpublic getBranches(sessionId?: string): Record<BranchId, ThoughtData[]> {\n\t\treturn this._getSession(sessionId, this._getCurrentOwner()).branches;\n\t}\n\n\tpublic getBranchIds(sessionId?: string): BranchId[] {\n\t\treturn Array.from(this._getSession(sessionId, this._getCurrentOwner()).branchIdentities);\n\t}\n\n\t/** Returns validation state without creating a session, binding an owner, or updating LRU data. */\n\tpublic inspectSession(sessionId: string): HistorySessionSnapshot {\n\t\tconst canonicalSessionId = asSessionId(sessionId);\n\t\tthis._authorizeExistingSession(canonicalSessionId, this._getCurrentOwner());\n\t\tconst session = this._sessions.get(canonicalSessionId);\n\t\tif (session === undefined) {\n\t\t\treturn {\n\t\t\t\thistory: [],\n\t\t\t\tbranches: {},\n\t\t\t\tbranchIds: [],\n\t\t\t\tavailableMcpTools: undefined,\n\t\t\t\tavailableSkills: undefined,\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\thistory: [...session.thought_history],\n\t\t\tbranches: Object.fromEntries(\n\t\t\t\tObject.entries(session.branches).map(([branchId, thoughts]) => [branchId, [...thoughts]])\n\t\t\t) as Record<BranchId, readonly ThoughtData[]>,\n\t\t\tbranchIds: Array.from(session.branchIdentities),\n\t\t\tavailableMcpTools:\n\t\t\t\tsession.availableMcpTools === undefined ? undefined : [...session.availableMcpTools],\n\t\t\tavailableSkills:\n\t\t\t\tsession.availableSkills === undefined ? undefined : [...session.availableSkills],\n\t\t};\n\t}\n\n\t/** @throws {ValidationError} If branchId is empty or already exists. */\n\tpublic registerBranch(sessionId: string | undefined, branchId: BranchId): void {\n\t\tif (typeof branchId !== 'string' || branchId.length === 0) {\n\t\t\tthrow new ValidationError('branch_id', 'branch_id must be a non-empty string');\n\t\t}\n\t\tconst canonicalSessionId = asSessionId(sessionId ?? HistoryManager.DEFAULT_SESSION);\n\t\tthis._lifecycle.runMutation(canonicalSessionId, () => {\n\t\t\tthis._persistenceBuffer?.assertSessionAdmissionOpen(canonicalSessionId);\n\t\t\tconst session = this._getSessionWithinOperation(canonicalSessionId, this._getCurrentOwner());\n\t\t\tif (session.branchIdentities.has(branchId)) {\n\t\t\t\tthrow new ValidationError('branch_id', `Branch already exists: ${branchId}`);\n\t\t\t}\n\t\t\tsession.branchIdentities.add(branchId);\n\t\t\tconst evictedBranchIds = this._cleanupSessionBranches(session);\n\t\t\tthis._rebuildReferenceIndex(canonicalSessionId, session);\n\t\t\tconst prunedEdges = this._pruneUnretainedEdges(canonicalSessionId, session);\n\t\t\tif (evictedBranchIds.length > 0 || session.pendingRestoreBranchDeletes.size > 0) {\n\t\t\t\tthis._stageBranchPersistence(canonicalSessionId, session, evictedBranchIds);\n\t\t\t}\n\t\t\tif (this._edgeStore !== undefined && prunedEdges > 0) {\n\t\t\t\tthis._persistenceBuffer?.bufferEdges(\n\t\t\t\t\tcanonicalSessionId,\n\t\t\t\t\tthis._edgeStore.edgesForSession(canonicalSessionId)\n\t\t\t\t);\n\t\t\t}\n\t\t\tthis.log('Registered branch', { branchId, sessionId: sessionId ?? null });\n\t\t});\n\t}\n\n\tpublic branchExists(sessionId: string | undefined, branchId: BranchId): boolean {\n\t\tconst session = this._getSession(sessionId, this._getCurrentOwner());\n\t\treturn session.branchIdentities.has(branchId);\n\t}\n\n\tpublic getAvailableMcpTools(sessionId?: string): string[] | undefined {\n\t\treturn this._getSession(sessionId, this._getCurrentOwner()).availableMcpTools;\n\t}\n\n\tpublic getAvailableSkills(sessionId?: string): string[] | undefined {\n\t\treturn this._getSession(sessionId, this._getCurrentOwner()).availableSkills;\n\t}\n\n\tpublic getBranch(branchId: BranchId, sessionId?: string): ThoughtData[] | undefined {\n\t\treturn this._getSession(sessionId, this._getCurrentOwner()).branches[branchId];\n\t}\n\n\t/** Clears only persistence-disabled state synchronously. */\n\tpublic clear(sessionId?: string): void {\n\t\tif (sessionId !== undefined) {\n\t\t\tconst canonicalSessionId = asSessionId(sessionId);\n\t\t\tthis._authorizeExistingSession(canonicalSessionId, this._getCurrentOwner());\n\t\t\tif (this._sessionLock?.isActive(canonicalSessionId) === true) {\n\t\t\t\tthrow new AsyncResetRequiredError('session', canonicalSessionId, 'active');\n\t\t\t}\n\t\t\tthis._resetCoordinator.clearSession(canonicalSessionId);\n\t\t\tthis._referenceIndex.clearSession(canonicalSessionId);\n\t\t\tthis._clearSessionAuxiliaryState?.(canonicalSessionId);\n\t\t\treturn;\n\t\t}\n\t\tthis._assertOwnerlessResetAll();\n\t\tif (this._sessionLock !== undefined && this._sessionLock.size > 0) {\n\t\t\tthrow new AsyncResetRequiredError('all', undefined, 'active');\n\t\t}\n\t\tthis._resetCoordinator.clearAll();\n\t\tthis._referenceIndex.clearAll();\n\t\tthis._clearAllAuxiliaryState?.();\n\t}\n\n\t/** Awaitably deletes one authorized durable namespace before replacing its live state. */\n\tpublic async resetSession(sessionId: string, clearAuxiliaryState?: () => void): Promise<void> {\n\t\tconst canonicalSessionId = asSessionId(sessionId);\n\t\tthis._authorizeExistingSession(canonicalSessionId, this._getCurrentOwner());\n\t\tawait this._lifecycle.withSessionReset(canonicalSessionId, async () => {\n\t\t\tconst reset = async (): Promise<void> =>\n\t\t\t\tawait this.resetSessionWithinExclusive(canonicalSessionId, clearAuxiliaryState);\n\t\t\tif (this._sessionLock === undefined) return await reset();\n\t\t\tawait this._sessionLock.withLock(canonicalSessionId, reset);\n\t\t});\n\t}\n\n\t/** Performs scoped reset work while its lifecycle exclusive is already owned. */\n\tpublic async resetSessionWithinExclusive(\n\t\tsessionId: SessionId,\n\t\tclearAuxiliaryState?: () => void\n\t): Promise<void> {\n\t\tconst preservedOwner = this._authorizeExistingSession(sessionId, this._getCurrentOwner());\n\t\tawait this._resetCoordinator.resetSession(\n\t\t\tsessionId,\n\t\t\tpreservedOwner,\n\t\t\tclearAuxiliaryState ??\n\t\t\t\t(this._clearSessionAuxiliaryState === undefined\n\t\t\t\t\t? undefined\n\t\t\t\t\t: () => this._clearSessionAuxiliaryState?.(sessionId))\n\t\t);\n\t\tthis._referenceIndex.clearSession(sessionId);\n\t}\n\n\t/** Awaitably deletes all durable namespaces from a trusted ownerless context. */\n\tpublic async resetAll(clearAuxiliaryState?: () => void): Promise<void> {\n\t\tthis._assertOwnerlessResetAll();\n\t\tawait this._lifecycle.withGlobalReset(\n\t\t\tasync () => await this.resetAllWithinExclusive(clearAuxiliaryState)\n\t\t);\n\t}\n\n\t/** Performs global reset work while its lifecycle exclusive is already owned. */\n\tpublic async resetAllWithinExclusive(clearAuxiliaryState?: () => void): Promise<void> {\n\t\tthis._assertOwnerlessResetAll();\n\t\tawait this._resetCoordinator.resetAll(clearAuxiliaryState ?? this._clearAllAuxiliaryState);\n\t\tthis._referenceIndex.clearAll();\n\t}\n\n\tpublic clearSession(sessionId: string): void {\n\t\tthis.clear(sessionId);\n\t}\n\n\tpublic getSessionIds(): string[] {\n\t\treturn Array.from(this._sessions.keys());\n\t}\n\n\tpublic getSessionCount(): number {\n\t\treturn this._sessions.size;\n\t}\n\n\tprivate _restoredState(restored: RestoredSession): SessionState {\n\t\tconst session = this._createSessionState(undefined, 'restored');\n\t\tfor (let index = restored.history.length - 1; index >= 0; index--) {\n\t\t\tconst thought = restored.history[index];\n\t\t\tif (thought === undefined) continue;\n\t\t\tif (session.availableMcpTools === undefined && thought.available_mcp_tools !== undefined) {\n\t\t\t\tsession.availableMcpTools = [...thought.available_mcp_tools];\n\t\t\t}\n\t\t\tif (session.availableSkills === undefined && thought.available_skills !== undefined) {\n\t\t\t\tsession.availableSkills = [...thought.available_skills];\n\t\t\t}\n\t\t\tif (session.availableMcpTools !== undefined && session.availableSkills !== undefined) break;\n\t\t}\n\t\tsession.thought_history = restored.history.slice(-this._maxHistorySize);\n\t\tconst retainedStart = Math.max(0, restored.branches.length - this._maxBranches);\n\t\tconst retainedBranches = restored.branches.slice(retainedStart);\n\t\tfor (const branch of restored.branches.slice(0, retainedStart)) {\n\t\t\tsession.pendingRestoreBranchDeletes.add(branch.branchId);\n\t\t}\n\t\tfor (const branch of retainedBranches) {\n\t\t\tsession.branchIdentities.add(branch.branchId);\n\t\t\tsession.branches[branch.branchId] = branch.thoughts.slice(-this._maxBranchSize);\n\t\t}\n\t\treturn session;\n\t}\n\n\t/** Loads and atomically commits every authoritative persistence namespace. Call at init. */\n\tpublic async loadFromPersistence(): Promise<void> {\n\t\tif (!this._persistenceEnabled || !this._persistence) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst restored = await stagePersistenceRestore(this._persistence);\n\t\tconst sessions = restored.sessions.map(\n\t\t\t(session) => [session.sessionId, this._restoredState(session)] as const\n\t\t);\n\t\tconst referenceIndex = new ThoughtReferenceIndex();\n\t\tconst retainedThoughtIds = new Map<SessionId, ReadonlySet<ThoughtId>>();\n\t\tconst retainedBranchThoughtIds = new Map<SessionId, ReadonlySet<ThoughtId>>();\n\t\tfor (const [sessionId, session] of sessions) {\n\t\t\tconst retained = [session.thought_history, ...Object.values(session.branches)].flat();\n\t\t\treferenceIndex.replaceSession(sessionId, retained);\n\t\t\tretainedThoughtIds.set(\n\t\t\t\tsessionId,\n\t\t\t\tnew Set(retained.flatMap((thought) => (thought.id === undefined ? [] : [thought.id])))\n\t\t\t);\n\t\t\tretainedBranchThoughtIds.set(\n\t\t\t\tsessionId,\n\t\t\t\tnew Set(\n\t\t\t\t\tObject.values(session.branches).flatMap((branch) =>\n\t\t\t\t\t\tbranch.flatMap((thought) => (thought.id === undefined ? [] : [thought.id]))\n\t\t\t\t\t)\n\t\t\t\t)\n\t\t\t);\n\t\t}\n\n\t\tthis._edgeStore?.clearAll();\n\t\tthis._summaryStore?.clearAll();\n\t\tthis._sessions.clear();\n\t\tfor (const [sessionId, session] of sessions) this._sessions.set(sessionId, session);\n\t\tthis._referenceIndex = referenceIndex;\n\t\tfor (const session of restored.sessions) {\n\t\t\tconst retainedIds = retainedThoughtIds.get(session.sessionId) ?? new Set<ThoughtId>();\n\t\t\tconst retainedBranchIds =\n\t\t\t\tretainedBranchThoughtIds.get(session.sessionId) ?? new Set<ThoughtId>();\n\t\t\tfor (const edge of session.edges) {\n\t\t\t\tif (!retainedIds.has(edge.from) || !retainedIds.has(edge.to)) continue;\n\t\t\t\tif (edge.kind === 'branch' && !retainedBranchIds.has(edge.to)) continue;\n\t\t\t\tthis._edgeStore?.addEdge(edge);\n\t\t\t}\n\t\t\tfor (const summary of session.summaries) this._summaryStore?.add(summary);\n\t\t}\n\t\tthis.log(`Restored ${restored.sessions.length} persistence namespaces`);\n\t}\n\n\tpublic isPersistenceEnabled(): boolean {\n\t\treturn this._persistenceEnabled;\n\t}\n\n\tpublic getPersistenceBackend(): PersistenceBackend | null {\n\t\treturn this._persistence;\n\t}\n\n\t/** Sets the event emitter for persistence error events (post-construction wiring). */\n\tpublic setEventEmitter(emitter: PersistenceEventEmitter): void {\n\t\tthis._eventEmitter = emitter;\n\t\tthis._persistenceBuffer?.setEventEmitter(emitter);\n\t}\n\n\t/**\n\t * Binds shutdown to the resource owner responsible for the complete cleanup sequence.\n\t *\n\t * @internal\n\t * @param owner - Callback returning the owner's memoized shutdown promise.\n\t * @throws {TypeError} When a shutdown owner has already been bound.\n\t */\n\tpublic bindShutdownOwner(owner: () => Promise<void>): void {\n\t\tif (this._shutdownOwner !== null) {\n\t\t\tthrow new TypeError('HistoryManager shutdown owner is already bound');\n\t\t}\n\t\tthis._shutdownOwner = owner;\n\t}\n\n\t/** Stops timers, drains writes, and clears live state under one memoized lifecycle settlement. */\n\tpublic shutdown(): Promise<void> {\n\t\tif (this._shutdownOwner !== null) return this._shutdownOwner();\n\t\treturn this._lifecycle.shutdown(async () => {\n\t\t\tawait this.shutdownWithinLifecycle();\n\t\t\tthis.clearLiveStateAfterShutdown();\n\t\t});\n\t}\n\n\t/** Stops timers and drains writes while the caller owns global shutdown. */\n\tpublic async shutdownWithinLifecycle(): Promise<void> {\n\t\tthis._stopFlushTimer();\n\t\tthis._sessionManager.stopCleanupTimer();\n\t\tawait this._flushBuffer();\n\t}\n\n\t/** Clears non-durable state after every shutdown resource has closed successfully. */\n\tpublic clearLiveStateAfterShutdown(): void {\n\t\tfor (const sessionId of this._sessions.keys()) {\n\t\t\tthis._persistenceBuffer?.forgetQuiescentSession(sessionId);\n\t\t}\n\t\tthis._sessions.clear();\n\t\tthis._referenceIndex.clearAll();\n\t\tthis._edgeStore?.clearAll();\n\t\tthis._summaryStore?.clearAll();\n\t\tthis._clearAllAuxiliaryState?.();\n\t}\n\n\t/** Number of coordinator-owned thought writes not yet acknowledged successful. */\n\tpublic getWriteBufferLength(): number {\n\t\treturn this._persistenceBuffer?.pendingThoughtCount ?? 0;\n\t}\n}\n"],"names":["ABSOLUTE_MAX_HISTORY_SIZE","HistoryManager","GLOBAL_SESSION_ID","Map","ThoughtReferenceIndex","config","NullLogger","requestedMaxSize","Math","SessionLifecycleCoordinator","EdgeEmitter","SessionManager","PersistenceBuffer","asSessionId","SessionResetCoordinator","owner","sessionId","sessionIds","Promise","session","undefined","summaries","message","meta","getOwner","key","existing","Date","SessionAccessDeniedError","victims","MaxSessionsReachedError","evicted","persistenceState","results","failures","result","AggregateError","provenance","Set","sessionOwner","firstSessionId","thought","context","resolvedReferences","edgeAdded","evictedBranchIds","prunedEdges","resolved","resolveThoughtReferencesForAdmission","thoughtNumber","InvalidBacktrackError","branchId","retainedIds","retainedBranchThoughtIds","Object","buffer","ordinaryDeletes","branch","branchIdsToDelete","targetId","t","branchThoughts","retained","branchCount","identitiesToRemove","Array","branchesToDelete","removed","opts","history","sid","policy","DehydrationPolicy","canonicalSessionId","thoughts","ValidationError","AsyncResetRequiredError","clearAuxiliaryState","reset","preservedOwner","restored","index","retainedStart","retainedBranches","stagePersistenceRestore","sessions","referenceIndex","retainedThoughtIds","retainedBranchIds","edge","summary","emitter","TypeError"],"mappings":"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"}

package/dist/core/IHistoryManager.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Interface for history and branch management.
+ *
+ * This module provides the `IHistoryManager` interface which defines the contract
+ * for history manager implementations. This allows for decoupling and testability.
+ *
+ * @module IHistoryManager
+ */
+import type { IEdgeStore } from '../contracts/interfaces.js';
+import type { BranchId, SessionId, ThoughtId } from '../contracts/ids.js';
+import type { ThoughtReferenceResolution } from './ThoughtReferenceIndex.js';
+import type { ThoughtData } from './thought.js';
+/** Non-mutating view used to validate one operation before state admission. */
+export interface HistorySessionSnapshot {
+    readonly history: readonly ThoughtData[];
+    readonly branches: Readonly<Record<BranchId, readonly ThoughtData[]>>;
+    readonly branchIds: readonly BranchId[];
+    readonly availableMcpTools: readonly string[] | undefined;
+    readonly availableSkills: readonly string[] | undefined;
+}
+export interface ResolvedThoughtReferences {
+    readonly verificationTargetThoughtId?: ThoughtId;
+    readonly revisesThoughtId?: ThoughtId;
+    readonly branchFromThoughtId?: ThoughtId;
+    readonly synthesisSourceThoughtIds?: readonly ThoughtId[];
+    readonly mergeFromThoughtIds?: readonly ThoughtId[];
+    readonly backtrackTargetThoughtId?: ThoughtId;
+}
+export interface ThoughtAdmissionContext {
+    readonly resolvedReferences?: ResolvedThoughtReferences;
+    readonly toolInvocationSourceThoughtId?: ThoughtId;
+}
+/**
+ * Interface for history and branch management.
+ *
+ * This interface defines the contract for history manager implementations,
+ * allowing for decoupling between components like ThoughtProcessor and
+ * concrete implementations. It supports dependency injection and mocking
+ * for testing purposes.
+ *
+ * @example
+ * ```typescript
+ * // Using the interface for dependency injection
+ * class MyComponent {
+ *   constructor(private history: IHistoryManager) {}
+ *
+ *   addThought(thought: ThoughtData) {
+ *     this.history.addThought(thought);
+ *   }
+ * }
+ *
+ * // Mock implementation for testing
+ * class MockHistoryManager implements IHistoryManager {
+ *   private _history: ThoughtData[] = [];
+ *   addThought(thought: ThoughtData): void { this._history.push(thought); }
+ *   getHistory(): ThoughtData[] { return this._history; }
+ *   getHistoryLength(): number { return this._history.length; }
+ *   getBranches(): Record<string, ThoughtData[]> { return {}; }
+ *   getBranchIds(): string[] { return []; }
+ *   clear(): void { this._history = []; }
+ * }
+ * ```
+ */
+export interface IHistoryManager {
+    /**
+     * Adds a thought to the history.
+     * Session is determined by `thought.session_id` (defaults to global session).
+     *
+     * @param thought - The thought data to add
+     */
+    addThought(thought: ThoughtData, context?: ThoughtAdmissionContext): void;
+    /** Resolves a retained same-session numeric reference to stable thought identity. */
+    resolveThoughtReference(sessionId: SessionId, thoughtNumber: number): ThoughtReferenceResolution;
+    /**
+     * Gets the complete thought history.
+     *
+     * @param sessionId - Optional session ID for session-scoped results
+     * @returns An array of all thoughts in chronological order
+     */
+    getHistory(sessionId?: string): ThoughtData[];
+    /**
+     * Gets the current length of the thought history.
+     *
+     * @param sessionId - Optional session ID for session-scoped results
+     * @returns The number of thoughts in history
+     */
+    getHistoryLength(sessionId?: string): number;
+    /**
+     * Gets all branches.
+     *
+     * @param sessionId - Optional session ID for session-scoped results
+     * @returns A record mapping branch IDs to their thought arrays
+     */
+    getBranches(sessionId?: string): Record<BranchId, ThoughtData[]>;
+    /**
+     * Gets all branch IDs.
+     *
+     * @param sessionId - Optional session ID for session-scoped results
+     * @returns An array of branch identifiers
+     */
+    getBranchIds(sessionId?: string): BranchId[];
+    /**
+     * Clears history and branches.
+     * If sessionId is provided, clears only that session.
+     * If omitted, clears all sessions.
+     *
+     * @param sessionId - Optional session ID to clear
+     */
+    clear(sessionId?: string): void;
+    /** Awaitably clears one authorized live and durable session. */
+    resetSession(sessionId: string, clearAuxiliaryState?: () => void): Promise<void>;
+    /** Clears one session while the caller already owns its lifecycle exclusive. */
+    resetSessionWithinExclusive(sessionId: SessionId, clearAuxiliaryState?: () => void): Promise<void>;
+    /** Awaitably clears every live and durable session from an ownerless context. */
+    resetAll(clearAuxiliaryState?: () => void): Promise<void>;
+    /** Clears every session while the caller already owns the global lifecycle exclusive. */
+    resetAllWithinExclusive(clearAuxiliaryState?: () => void): Promise<void>;
+    /** Returns a non-mutating session snapshot without creating or binding state. */
+    inspectSession(sessionId: string): HistorySessionSnapshot;
+    /** Returns the currently materialized session identifiers without binding ownership. */
+    getSessionIds(): string[];
+    /**
+     * Gets the most recently available MCP tools from the session.
+     *
+     * @param sessionId - Optional session ID for session-scoped results
+     * @returns The last-seen array of MCP tool names, or undefined if never set
+     */
+    getAvailableMcpTools(sessionId?: string): string[] | undefined;
+    /**
+     * Gets the most recently available skills from the session.
+     *
+     * @param sessionId - Optional session ID for session-scoped results
+     * @returns The last-seen array of skill names, or undefined if never set
+     */
+    getAvailableSkills(sessionId?: string): string[] | undefined;
+    /**
+     * Pre-declares a branch ID without adding any thoughts.
+     * Allows merge_branch_ids to reference branches that have not yet received thoughts.
+     *
+     * @param sessionId - Optional session ID (defaults to global session)
+     * @param branchId - The branch identifier to register
+     * @throws ValidationError if branchId is empty or already exists
+     */
+    registerBranch(sessionId: string | undefined, branchId: BranchId): void;
+    /**
+     * Checks whether a branch exists (has thoughts OR was pre-declared).
+     *
+     * @param sessionId - Optional session ID (defaults to global session)
+     * @param branchId - The branch identifier to check
+     * @returns true if the branch exists or has been registered
+     */
+    branchExists(sessionId: string | undefined, branchId: BranchId): boolean;
+    /**
+     * Access the EdgeStore, if configured.
+     *
+     * Returns undefined when DAG edges are not enabled.
+     * Used by ThoughtProcessor to build StrategyContext.
+     *
+     * @returns The edge store, or undefined if not configured
+     */
+    getEdgeStore(): IEdgeStore | undefined;
+}
+//# sourceMappingURL=IHistoryManager.d.ts.map

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

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

package/dist/core/IHistoryManager.js

@@ -0,0 +1 @@
+export { };

package/dist/core/IThoughtFormatter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Interface for thought and step recommendation formatting.
+ *
+ * This module provides the `IThoughtFormatter` interface which defines the
+ * contract for formatter implementations. This allows for decoupling and
+ * testability of presentation logic.
+ *
+ * @module IThoughtFormatter
+ */
+import type { StepRecommendation } from './step.js';
+import type { ThoughtData } from './thought.js';
+/**
+ * Interface for formatting thought data and step recommendations.
+ *
+ * This interface defines the contract for formatter implementations,
+ * allowing for decoupling between components like ThoughtProcessor and
+ * concrete implementations. It supports dependency injection and mocking
+ * for testing purposes.
+ *
+ * @example
+ * ```typescript
+ * class MockFormatter implements IThoughtFormatter {
+ *   formatRecommendation(_step: StepRecommendation): string { return ''; }
+ *   formatThought(_thought: ThoughtData): string { return ''; }
+ * }
+ * ```
+ */
+export interface 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
+     */
+    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`.
+     *
+     * @param thoughtData - The thought data to format
+     * @returns A formatted string with thought and recommendations
+     */
+    formatThought(thoughtData: ThoughtData): string;
+}
+//# sourceMappingURL=IThoughtFormatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IThoughtFormatter.d.ts","sourceRoot":"","sources":["../../src/core/IThoughtFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAAC;IAEvD;;;;;;;;;OASG;IACH,aAAa,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC;CAChD"}

package/dist/core/IThoughtFormatter.js

@@ -0,0 +1 @@
+export { };

package/dist/core/InputNormalizer.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Input normalization for common LLM field name mistakes.
+ *
+ * This module provides normalization logic to handle common mistakes
+ * that LLMs make when generating field names, such as using singular
+ * instead of plural forms (e.g., `recommended_tool` vs `recommended_tools`).
+ *
+ * It also fills in sensible defaults for missing fields in `previous_steps`,
+ * which LLMs naturally provide as partial/skeletal data (historical context).
+ *
+ * @module processor
+ */
+import type { ThoughtData } from './thought.js';
+import { type BranchId } from '../contracts/ids.js';
+/**
+ * Recursively sanitizes all string values within an unknown structure.
+ * Walks into plain objects and arrays to reach deeply nested strings.
+ * Non-plain objects (Date, RegExp, etc.) are returned as-is.
+ *
+ * @param value - The value to sanitize recursively
+ * @returns The sanitized value with all nested strings cleaned
+ *
+ * @example
+ * ```typescript
+ * sanitizeRecursive('<script>x</script>'); // 'x'
+ * sanitizeRecursive({ a: { b: '<iframe>y' } }); // { a: { b: 'y' } }
+ * sanitizeRecursive(['a\x00b', 42]); // ['ab', 42]
+ * ```
+ */
+export declare function sanitizeRecursive(value: unknown): unknown;
+/**
+ * Sanitizes and validates a branch ID to prevent path traversal attacks.
+ *
+ * @param branchId - The branch ID to sanitize
+ * @returns The sanitized branch ID
+ * @throws ValidationError if the branch ID contains invalid characters
+ *
+ * @example
+ * ```typescript
+ * sanitizeBranchId('my-branch_01'); // 'my-branch_01'
+ * sanitizeBranchId('../etc/passwd'); // throws ValidationError
+ * ```
+ */
+export declare function sanitizeBranchId(branchId: string): BranchId;
+/**
+ * Sanitizes and validates a session ID.
+ *
+ * @param sessionId - The session ID to sanitize
+ * @returns The sanitized session ID, or undefined if invalid after sanitization
+ *
+ * @example
+ * ```typescript
+ * sanitizeSessionId('analysis-task-42'); // 'analysis-task-42'
+ * sanitizeSessionId('bad session!'); // undefined (stripped)
+ * ```
+ */
+export declare function sanitizeSessionId(sessionId: string): string | undefined;
+/**
+ * Normalizes reasoning-specific fields on a thought input object.
+ * Always applies reasoning normalization — reasoning is the default pipeline.
+ * Applies the following normalization rules:
+ * - Defaults `thought_type` to `'regular'` if not provided
+ * - Clamps `quality_score` to [0, 1] range
+ * - Clamps `confidence` to [0, 1] range
+ * - Sanitizes `hypothesis_id` using `sanitizeBranchId` pattern
+ * - Filters `synthesis_sources` to positive integers only
+ * - Filters `merge_from_thoughts` to positive integers only
+ * - Sanitizes each entry in `merge_branch_ids`
+ * - Defaults `reasoning_depth` to `'moderate'` for hypothesis/verification types
+ *
+ * @param input - The mutable normalized input object to apply reasoning defaults to
+ *
+ * @example
+ * ```typescript
+ * const input: Record<string, unknown> = { thought_type: 'hypothesis', quality_score: 1.5 };
+ * normalizeReasoningFields(input);
+ * // input.quality_score === 1, input.reasoning_depth === 'moderate'
+ * ```
+ */
+export declare function normalizeReasoningFields(input: Record<string, unknown>): void;
+/**
+ * Normalizes thought input data by fixing common LLM field name mistakes.
+ *
+ * This function handles cases where LLMs incorrectly use singular forms
+ * of field names that should be plural. It applies normalization to both
+ * `current_step` and `previous_steps` fields.
+ *
+ * The normalization is applied BEFORE schema validation, allowing the
+ * strict Valibot schema to remain correct while still being tolerant
+ * of common LLM mistakes.
+ *
+ * @param input - The raw thought input data to normalize
+ * @returns Normalized thought data with correct field names
+ *
+ * @remarks
+ * **Normalization Rules:**
+ * - `recommended_tool` (singular) → `recommended_tools` (plural)
+ * - `recommended_skill` (singular) → `recommended_skills` (plural)
+ * - Applied to `current_step` if present (strict mode)
+ * - Applied to all items in `previous_steps` if present (lenient mode with defaults)
+ *
+ * **Design Rationale:**
+ * LLMs sometimes use singular field names even when the schema explicitly
+ * defines plural forms. Rather than forcing the LLM to be perfect (which
+ * leads to cryptic validation errors), we normalize the input to handle
+ * these common mistakes gracefully.
+ *
+ * Additionally, LLMs naturally provide complete data for `current_step`
+ * but only partial/skeletal data for `previous_steps` (historical context).
+ * The lenient mode for `previous_steps` fills in sensible defaults:
+ * - `confidence`: 0.5 for missing tool recommendation confidence
+ * - `priority`: 999 for missing tool recommendation priority
+ * - `rationale`: empty string for missing tool recommendation rationale
+ * - `expected_outcome`: empty string for missing step expected outcome
+ *
+ * @example
+ * ```typescript
+ * const input = {
+ *   thought: 'I need to analyze the data',
+ *   thought_number: 1,
+ *   total_thoughts: 3,
+ *   next_thought_needed: true,
+ *   current_step: {
+ *     step_description: 'Read the data file',
+ *     recommended_tool: [{ tool_name: 'Read', confidence: 0.9, rationale: 'test', priority: 1 }],
+ *     expected_outcome: 'Data loaded'
+ *   },
+ *   previous_steps: [{
+ *     step_description: 'Previous step',
+ *     recommended_tools: [{ tool_name: 'Grep', rationale: 'Search code' }]
+ *   }]
+ * };
+ *
+ * const normalized = normalizeInput(input);
+ * // current_step: recommended_tools exists (plural form)
+ * // previous_steps[0]: confidence=0.5, priority=999, expected_outcome='' filled in
+ * ```
+ */
+export declare function normalizeInput(input: unknown): ThoughtData;
+//# sourceMappingURL=InputNormalizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InputNormalizer.d.ts","sourceRoot":"","sources":["../../src/core/InputNormalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAA8C,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAYhG;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAuBzD;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAS3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQvE;AA6ID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAsD7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAwD1D"}

package/dist/core/InputNormalizer.js

@@ -0,0 +1,95 @@
+import { ValidationError } from "../errors.js";
+import { sanitizeRationale, sanitizeStepField, sanitizeString, sanitizeSuggestedInputs } from "../sanitize.js";
+import { MAX_SESSION_ID_LENGTH, SESSION_ID_PATTERN } from "./ids.js";
+import { asBranchId, asSessionId, generateThoughtId } from "../contracts/ids.js";
+const DEFAULT_RECOMMENDATION_CONFIDENCE = 0.5;
+const DEFAULT_RECOMMENDATION_PRIORITY = 999;
+const DEFAULT_RECOMMENDATION_RATIONALE = '';
+const DEFAULT_STEP_OUTCOME = '';
+function sanitizeRecursive(value) {
+    if (null == value) return value;
+    if ('string' == typeof value) return sanitizeString(value);
+    if (Array.isArray(value)) return value.map((item)=>sanitizeRecursive(item));
+    if ('object' == typeof value) {
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== Object.prototype && null !== proto) return value;
+        const result = {};
+        for (const [key, val] of Object.entries(value))result[key] = sanitizeRecursive(val);
+        return result;
+    }
+    return value;
+}
+const BRANCH_ID_PATTERN = /^[a-zA-Z0-9_-]{1,64}$/;
+function sanitizeBranchId(branchId) {
+    if (!BRANCH_ID_PATTERN.test(branchId)) throw new ValidationError('branch_id', 'Invalid format - must be 1-64 alphanumeric characters, hyphens, or underscores only');
+    return asBranchId(branchId);
+}
+function sanitizeSessionId(sessionId) {
+    const cleaned = sanitizeString(sessionId);
+    if (cleaned.length > MAX_SESSION_ID_LENGTH || !SESSION_ID_PATTERN.test(cleaned)) return;
+    return cleaned;
+}
+function normalizeRecommendation(rec) {
+    const normalized = {
+        ...rec
+    };
+    if (!('confidence' in normalized) || void 0 === normalized.confidence) normalized.confidence = DEFAULT_RECOMMENDATION_CONFIDENCE;
+    if (!('priority' in normalized) || void 0 === normalized.priority) normalized.priority = DEFAULT_RECOMMENDATION_PRIORITY;
+    if ('rationale' in normalized && void 0 !== normalized.rationale) {
+        if ('string' == typeof normalized.rationale) normalized.rationale = sanitizeRationale(normalized.rationale);
+    } else normalized.rationale = DEFAULT_RECOMMENDATION_RATIONALE;
+    if (normalized.suggested_inputs && 'object' == typeof normalized.suggested_inputs && !Array.isArray(normalized.suggested_inputs)) normalized.suggested_inputs = sanitizeSuggestedInputs(normalized.suggested_inputs);
+    return normalized;
+}
+function normalizeStepRecommendation(step, lenient) {
+    const normalized = {
+        ...step
+    };
+    if ('recommended_tool' in normalized && !('recommended_tools' in normalized)) {
+        normalized.recommended_tools = normalized.recommended_tool;
+        delete normalized.recommended_tool;
+    }
+    if ('recommended_skill' in normalized && !('recommended_skills' in normalized)) {
+        normalized.recommended_skills = normalized.recommended_skill;
+        delete normalized.recommended_skill;
+    }
+    if (Array.isArray(normalized.recommended_tools)) normalized.recommended_tools = normalized.recommended_tools.map((tool)=>'object' == typeof tool && null !== tool ? normalizeRecommendation(tool) : tool);
+    if (Array.isArray(normalized.recommended_skills)) normalized.recommended_skills = normalized.recommended_skills.map((skill)=>'object' == typeof skill && null !== skill ? normalizeRecommendation(skill) : skill);
+    if ('string' == typeof normalized.step_description) normalized.step_description = sanitizeStepField(normalized.step_description);
+    if ('string' == typeof normalized.expected_outcome) normalized.expected_outcome = sanitizeStepField(normalized.expected_outcome);
+    if (Array.isArray(normalized.next_step_conditions)) normalized.next_step_conditions = normalized.next_step_conditions.map((cond)=>'string' == typeof cond ? sanitizeStepField(cond) : cond);
+    if (lenient && !('expected_outcome' in normalized)) normalized.expected_outcome = DEFAULT_STEP_OUTCOME;
+    return normalized;
+}
+function normalizeReasoningFields(input) {
+    if (!('thought_type' in input) || void 0 === input.thought_type) input.thought_type = 'regular';
+    if ('number' == typeof input.quality_score) input.quality_score = Math.max(0, Math.min(1, input.quality_score));
+    if ('number' == typeof input.confidence) input.confidence = Math.max(0, Math.min(1, input.confidence));
+    if ('string' == typeof input.hypothesis_id) input.hypothesis_id = sanitizeBranchId(input.hypothesis_id);
+    if (Array.isArray(input.synthesis_sources)) input.synthesis_sources = input.synthesis_sources.filter((v)=>'number' == typeof v && Number.isInteger(v) && v > 0);
+    if (Array.isArray(input.merge_from_thoughts)) input.merge_from_thoughts = input.merge_from_thoughts.filter((v)=>'number' == typeof v && Number.isInteger(v) && v > 0);
+    if (Array.isArray(input.merge_branch_ids)) input.merge_branch_ids = input.merge_branch_ids.map((id)=>{
+        if ('string' == typeof id) return sanitizeBranchId(id);
+        return id;
+    });
+    if (('hypothesis' === input.thought_type || 'verification' === input.thought_type) && !('reasoning_depth' in input)) input.reasoning_depth = 'moderate';
+}
+function normalizeInput(input) {
+    if ('object' != typeof input || null === input) return input;
+    const normalized = {
+        ...input
+    };
+    if (normalized.current_step && 'object' == typeof normalized.current_step) normalized.current_step = normalizeStepRecommendation(normalized.current_step, false);
+    if (Array.isArray(normalized.previous_steps) && normalized.previous_steps.length > 0) normalized.previous_steps = normalized.previous_steps.map((step)=>'object' == typeof step && null !== step ? normalizeStepRecommendation(step, true) : step);
+    if ('string' == typeof normalized.branch_id) normalized.branch_id = sanitizeBranchId(normalized.branch_id);
+    if ('string' == typeof normalized.session_id) normalized.session_id = asSessionId(normalized.session_id);
+    if ('string' == typeof normalized.register_branch_id) normalized.register_branch_id = sanitizeBranchId(normalized.register_branch_id);
+    if (!normalized.id || 'string' != typeof normalized.id) normalized.id = generateThoughtId();
+    normalizeReasoningFields(normalized);
+    if ('string' == typeof normalized.meta_observation) normalized.meta_observation = sanitizeStepField(normalized.meta_observation);
+    const sanitized = sanitizeRecursive(normalized);
+    return sanitized;
+}
+export { normalizeInput, normalizeReasoningFields, sanitizeBranchId, sanitizeRecursive, sanitizeSessionId };
+
+//# sourceMappingURL=InputNormalizer.js.map