@iworkforces/tracelattice 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (422) hide show
  1. package/LICENSE +24 -0
  2. package/README.md +260 -0
  3. package/dist/CliLifecycle.d.ts +31 -0
  4. package/dist/CliLifecycle.d.ts.map +1 -0
  5. package/dist/CliLifecycle.js +90 -0
  6. package/dist/CliLifecycle.js.map +1 -0
  7. package/dist/ServerConfig.d.ts +290 -0
  8. package/dist/ServerConfig.d.ts.map +1 -0
  9. package/dist/ServerConfig.js +175 -0
  10. package/dist/ServerConfig.js.map +1 -0
  11. package/dist/cache/DiscoveryCache.d.ts +269 -0
  12. package/dist/cache/DiscoveryCache.d.ts.map +1 -0
  13. package/dist/cache/DiscoveryCache.js +104 -0
  14. package/dist/cache/DiscoveryCache.js.map +1 -0
  15. package/dist/cli.d.ts +3 -0
  16. package/dist/cli.d.ts.map +1 -0
  17. package/dist/cli.js +5177 -0
  18. package/dist/cli.js.map +1 -0
  19. package/dist/config/ConfigLoader.d.ts +270 -0
  20. package/dist/config/ConfigLoader.d.ts.map +1 -0
  21. package/dist/config/ConfigLoader.js +186 -0
  22. package/dist/config/ConfigLoader.js.map +1 -0
  23. package/dist/context/RequestContext.d.ts +43 -0
  24. package/dist/context/RequestContext.d.ts.map +1 -0
  25. package/dist/context/RequestContext.js +14 -0
  26. package/dist/context/RequestContext.js.map +1 -0
  27. package/dist/contracts/PersistenceBackend.d.ts +134 -0
  28. package/dist/contracts/PersistenceBackend.d.ts.map +1 -0
  29. package/dist/contracts/PersistenceBackend.js +6 -0
  30. package/dist/contracts/PersistenceBackend.js.map +1 -0
  31. package/dist/contracts/calibrator.d.ts +97 -0
  32. package/dist/contracts/calibrator.d.ts.map +1 -0
  33. package/dist/contracts/calibrator.js +1 -0
  34. package/dist/contracts/features.d.ts +35 -0
  35. package/dist/contracts/features.d.ts.map +1 -0
  36. package/dist/contracts/features.js +12 -0
  37. package/dist/contracts/features.js.map +1 -0
  38. package/dist/contracts/ids.d.ts +68 -0
  39. package/dist/contracts/ids.d.ts.map +1 -0
  40. package/dist/contracts/ids.js +40 -0
  41. package/dist/contracts/ids.js.map +1 -0
  42. package/dist/contracts/interfaces.d.ts +254 -0
  43. package/dist/contracts/interfaces.d.ts.map +1 -0
  44. package/dist/contracts/interfaces.js +1 -0
  45. package/dist/contracts/persistence-work.d.ts +96 -0
  46. package/dist/contracts/persistence-work.d.ts.map +1 -0
  47. package/dist/contracts/persistence-work.js +1 -0
  48. package/dist/contracts/reasoning-types.d.ts +21 -0
  49. package/dist/contracts/reasoning-types.d.ts.map +1 -0
  50. package/dist/contracts/reasoning-types.js +1 -0
  51. package/dist/contracts/strategy.d.ts +107 -0
  52. package/dist/contracts/strategy.d.ts.map +1 -0
  53. package/dist/contracts/strategy.js +1 -0
  54. package/dist/contracts/summary.d.ts +110 -0
  55. package/dist/contracts/summary.d.ts.map +1 -0
  56. package/dist/contracts/summary.js +1 -0
  57. package/dist/contracts/suspension.d.ts +215 -0
  58. package/dist/contracts/suspension.d.ts.map +1 -0
  59. package/dist/contracts/suspension.js +1 -0
  60. package/dist/contracts/transport.d.ts +26 -0
  61. package/dist/contracts/transport.d.ts.map +1 -0
  62. package/dist/contracts/transport.js +1 -0
  63. package/dist/core/CrossReferenceValidator.d.ts +18 -0
  64. package/dist/core/CrossReferenceValidator.d.ts.map +1 -0
  65. package/dist/core/CrossReferenceValidator.js +125 -0
  66. package/dist/core/CrossReferenceValidator.js.map +1 -0
  67. package/dist/core/HistoryManager.d.ts +215 -0
  68. package/dist/core/HistoryManager.d.ts.map +1 -0
  69. package/dist/core/HistoryManager.js +594 -0
  70. package/dist/core/HistoryManager.js.map +1 -0
  71. package/dist/core/IHistoryManager.d.ts +163 -0
  72. package/dist/core/IHistoryManager.d.ts.map +1 -0
  73. package/dist/core/IHistoryManager.js +1 -0
  74. package/dist/core/IThoughtFormatter.d.ts +51 -0
  75. package/dist/core/IThoughtFormatter.d.ts.map +1 -0
  76. package/dist/core/IThoughtFormatter.js +1 -0
  77. package/dist/core/InputNormalizer.d.ts +140 -0
  78. package/dist/core/InputNormalizer.d.ts.map +1 -0
  79. package/dist/core/InputNormalizer.js +95 -0
  80. package/dist/core/InputNormalizer.js.map +1 -0
  81. package/dist/core/PersistenceBuffer.d.ts +204 -0
  82. package/dist/core/PersistenceBuffer.d.ts.map +1 -0
  83. package/dist/core/PersistenceBuffer.js +382 -0
  84. package/dist/core/PersistenceBuffer.js.map +1 -0
  85. package/dist/core/PersistenceBufferErrors.d.ts +22 -0
  86. package/dist/core/PersistenceBufferErrors.d.ts.map +1 -0
  87. package/dist/core/PersistenceBufferErrors.js +30 -0
  88. package/dist/core/PersistenceBufferErrors.js.map +1 -0
  89. package/dist/core/PersistenceRestore.d.ts +21 -0
  90. package/dist/core/PersistenceRestore.d.ts.map +1 -0
  91. package/dist/core/PersistenceRestore.js +87 -0
  92. package/dist/core/PersistenceRestore.js.map +1 -0
  93. package/dist/core/PersistenceWorkQueue.d.ts +155 -0
  94. package/dist/core/PersistenceWorkQueue.d.ts.map +1 -0
  95. package/dist/core/PersistenceWorkQueue.js +298 -0
  96. package/dist/core/PersistenceWorkQueue.js.map +1 -0
  97. package/dist/core/PersistenceWriter.d.ts +55 -0
  98. package/dist/core/PersistenceWriter.d.ts.map +1 -0
  99. package/dist/core/PersistenceWriter.js +112 -0
  100. package/dist/core/PersistenceWriter.js.map +1 -0
  101. package/dist/core/SessionErrors.d.ts +37 -0
  102. package/dist/core/SessionErrors.d.ts.map +1 -0
  103. package/dist/core/SessionErrors.js +50 -0
  104. package/dist/core/SessionErrors.js.map +1 -0
  105. package/dist/core/SessionLifecycleCoordinator.d.ts +74 -0
  106. package/dist/core/SessionLifecycleCoordinator.d.ts.map +1 -0
  107. package/dist/core/SessionLifecycleCoordinator.js +222 -0
  108. package/dist/core/SessionLifecycleCoordinator.js.map +1 -0
  109. package/dist/core/SessionLock.d.ts +59 -0
  110. package/dist/core/SessionLock.d.ts.map +1 -0
  111. package/dist/core/SessionLock.js +39 -0
  112. package/dist/core/SessionLock.js.map +1 -0
  113. package/dist/core/SessionManager.d.ts +62 -0
  114. package/dist/core/SessionManager.d.ts.map +1 -0
  115. package/dist/core/SessionManager.js +75 -0
  116. package/dist/core/SessionManager.js.map +1 -0
  117. package/dist/core/SessionResetCoordinator.d.ts +37 -0
  118. package/dist/core/SessionResetCoordinator.d.ts.map +1 -0
  119. package/dist/core/SessionResetCoordinator.js +80 -0
  120. package/dist/core/SessionResetCoordinator.js.map +1 -0
  121. package/dist/core/ThoughtEvaluator.d.ts +48 -0
  122. package/dist/core/ThoughtEvaluator.d.ts.map +1 -0
  123. package/dist/core/ThoughtEvaluator.js +85 -0
  124. package/dist/core/ThoughtEvaluator.js.map +1 -0
  125. package/dist/core/ThoughtFormatter.d.ts +134 -0
  126. package/dist/core/ThoughtFormatter.d.ts.map +1 -0
  127. package/dist/core/ThoughtFormatter.js +118 -0
  128. package/dist/core/ThoughtFormatter.js.map +1 -0
  129. package/dist/core/ThoughtProcessor.d.ts +259 -0
  130. package/dist/core/ThoughtProcessor.d.ts.map +1 -0
  131. package/dist/core/ThoughtProcessor.js +451 -0
  132. package/dist/core/ThoughtProcessor.js.map +1 -0
  133. package/dist/core/ThoughtReferenceIndex.d.ts +23 -0
  134. package/dist/core/ThoughtReferenceIndex.d.ts.map +1 -0
  135. package/dist/core/ThoughtReferenceIndex.js +66 -0
  136. package/dist/core/ThoughtReferenceIndex.js.map +1 -0
  137. package/dist/core/VerificationOutcomeAdmission.d.ts +15 -0
  138. package/dist/core/VerificationOutcomeAdmission.d.ts.map +1 -0
  139. package/dist/core/VerificationOutcomeAdmission.js +28 -0
  140. package/dist/core/VerificationOutcomeAdmission.js.map +1 -0
  141. package/dist/core/compression/CompressionService.d.ts +76 -0
  142. package/dist/core/compression/CompressionService.d.ts.map +1 -0
  143. package/dist/core/compression/CompressionService.js +160 -0
  144. package/dist/core/compression/CompressionService.js.map +1 -0
  145. package/dist/core/compression/DehydrationPolicy.d.ts +75 -0
  146. package/dist/core/compression/DehydrationPolicy.d.ts.map +1 -0
  147. package/dist/core/compression/DehydrationPolicy.js +45 -0
  148. package/dist/core/compression/DehydrationPolicy.js.map +1 -0
  149. package/dist/core/compression/InMemorySummaryStore.d.ts +132 -0
  150. package/dist/core/compression/InMemorySummaryStore.d.ts.map +1 -0
  151. package/dist/core/compression/InMemorySummaryStore.js +69 -0
  152. package/dist/core/compression/InMemorySummaryStore.js.map +1 -0
  153. package/dist/core/compression/Summary.d.ts +74 -0
  154. package/dist/core/compression/Summary.d.ts.map +1 -0
  155. package/dist/core/compression/Summary.js +16 -0
  156. package/dist/core/compression/Summary.js.map +1 -0
  157. package/dist/core/evaluator/Aggregator.d.ts +40 -0
  158. package/dist/core/evaluator/Aggregator.d.ts.map +1 -0
  159. package/dist/core/evaluator/Aggregator.js +36 -0
  160. package/dist/core/evaluator/Aggregator.js.map +1 -0
  161. package/dist/core/evaluator/Calibrator.d.ts +52 -0
  162. package/dist/core/evaluator/Calibrator.d.ts.map +1 -0
  163. package/dist/core/evaluator/Calibrator.js +135 -0
  164. package/dist/core/evaluator/Calibrator.js.map +1 -0
  165. package/dist/core/evaluator/PatternDetector.d.ts +69 -0
  166. package/dist/core/evaluator/PatternDetector.d.ts.map +1 -0
  167. package/dist/core/evaluator/PatternDetector.js +192 -0
  168. package/dist/core/evaluator/PatternDetector.js.map +1 -0
  169. package/dist/core/evaluator/SignalComputer.d.ts +116 -0
  170. package/dist/core/evaluator/SignalComputer.d.ts.map +1 -0
  171. package/dist/core/evaluator/SignalComputer.js +110 -0
  172. package/dist/core/evaluator/SignalComputer.js.map +1 -0
  173. package/dist/core/evaluator/calibration-math.d.ts +39 -0
  174. package/dist/core/evaluator/calibration-math.d.ts.map +1 -0
  175. package/dist/core/evaluator/calibration-math.js +42 -0
  176. package/dist/core/evaluator/calibration-math.js.map +1 -0
  177. package/dist/core/evaluator/internals.d.ts +36 -0
  178. package/dist/core/evaluator/internals.d.ts.map +1 -0
  179. package/dist/core/evaluator/internals.js +43 -0
  180. package/dist/core/evaluator/internals.js.map +1 -0
  181. package/dist/core/graph/Edge.d.ts +58 -0
  182. package/dist/core/graph/Edge.d.ts.map +1 -0
  183. package/dist/core/graph/Edge.js +1 -0
  184. package/dist/core/graph/EdgeEmitter.d.ts +68 -0
  185. package/dist/core/graph/EdgeEmitter.d.ts.map +1 -0
  186. package/dist/core/graph/EdgeEmitter.js +118 -0
  187. package/dist/core/graph/EdgeEmitter.js.map +1 -0
  188. package/dist/core/graph/EdgeStore.d.ts +116 -0
  189. package/dist/core/graph/EdgeStore.d.ts.map +1 -0
  190. package/dist/core/graph/EdgeStore.js +107 -0
  191. package/dist/core/graph/EdgeStore.js.map +1 -0
  192. package/dist/core/graph/GraphView.d.ts +157 -0
  193. package/dist/core/graph/GraphView.d.ts.map +1 -0
  194. package/dist/core/graph/GraphView.js +149 -0
  195. package/dist/core/graph/GraphView.js.map +1 -0
  196. package/dist/core/ids.d.ts +33 -0
  197. package/dist/core/ids.d.ts.map +1 -0
  198. package/dist/core/ids.js +11 -0
  199. package/dist/core/ids.js.map +1 -0
  200. package/dist/core/reasoning/OutcomeRecorder.d.ts +88 -0
  201. package/dist/core/reasoning/OutcomeRecorder.d.ts.map +1 -0
  202. package/dist/core/reasoning/OutcomeRecorder.js +51 -0
  203. package/dist/core/reasoning/OutcomeRecorder.js.map +1 -0
  204. package/dist/core/reasoning/strategies/SequentialStrategy.d.ts +54 -0
  205. package/dist/core/reasoning/strategies/SequentialStrategy.d.ts.map +1 -0
  206. package/dist/core/reasoning/strategies/SequentialStrategy.js +22 -0
  207. package/dist/core/reasoning/strategies/SequentialStrategy.js.map +1 -0
  208. package/dist/core/reasoning/strategies/StrategyFactory.d.ts +25 -0
  209. package/dist/core/reasoning/strategies/StrategyFactory.d.ts.map +1 -0
  210. package/dist/core/reasoning/strategies/StrategyFactory.js +16 -0
  211. package/dist/core/reasoning/strategies/StrategyFactory.js.map +1 -0
  212. package/dist/core/reasoning/strategies/TreeOfThoughtStrategy.d.ts +58 -0
  213. package/dist/core/reasoning/strategies/TreeOfThoughtStrategy.d.ts.map +1 -0
  214. package/dist/core/reasoning/strategies/TreeOfThoughtStrategy.js +103 -0
  215. package/dist/core/reasoning/strategies/TreeOfThoughtStrategy.js.map +1 -0
  216. package/dist/core/reasoning/strategies/plateau.d.ts +18 -0
  217. package/dist/core/reasoning/strategies/plateau.d.ts.map +1 -0
  218. package/dist/core/reasoning/strategies/plateau.js +12 -0
  219. package/dist/core/reasoning/strategies/plateau.js.map +1 -0
  220. package/dist/core/reasoning/strategies/totScoring.d.ts +91 -0
  221. package/dist/core/reasoning/strategies/totScoring.d.ts.map +1 -0
  222. package/dist/core/reasoning/strategies/totScoring.js +88 -0
  223. package/dist/core/reasoning/strategies/totScoring.js.map +1 -0
  224. package/dist/core/reasoning.d.ts +179 -0
  225. package/dist/core/reasoning.d.ts.map +1 -0
  226. package/dist/core/reasoning.js +1 -0
  227. package/dist/core/step.d.ts +50 -0
  228. package/dist/core/step.d.ts.map +1 -0
  229. package/dist/core/step.js +1 -0
  230. package/dist/core/thought.d.ts +113 -0
  231. package/dist/core/thought.d.ts.map +1 -0
  232. package/dist/core/thought.js +1 -0
  233. package/dist/core/tools/InMemorySuspensionStore.d.ts +66 -0
  234. package/dist/core/tools/InMemorySuspensionStore.d.ts.map +1 -0
  235. package/dist/core/tools/InMemorySuspensionStore.js +121 -0
  236. package/dist/core/tools/InMemorySuspensionStore.js.map +1 -0
  237. package/dist/di/Container.d.ts +253 -0
  238. package/dist/di/Container.d.ts.map +1 -0
  239. package/dist/di/Container.js +111 -0
  240. package/dist/di/Container.js.map +1 -0
  241. package/dist/di/ServiceRegistry.d.ts +50 -0
  242. package/dist/di/ServiceRegistry.d.ts.map +1 -0
  243. package/dist/di/ServiceRegistry.js +1 -0
  244. package/dist/errors.d.ts +663 -0
  245. package/dist/errors.d.ts.map +1 -0
  246. package/dist/errors.js +282 -0
  247. package/dist/errors.js.map +1 -0
  248. package/dist/health/HealthChecker.d.ts +73 -0
  249. package/dist/health/HealthChecker.d.ts.map +1 -0
  250. package/dist/health/HealthChecker.js +70 -0
  251. package/dist/health/HealthChecker.js.map +1 -0
  252. package/dist/lib.d.ts +273 -0
  253. package/dist/lib.d.ts.map +1 -0
  254. package/dist/lib.js +409 -0
  255. package/dist/lib.js.map +1 -0
  256. package/dist/logger/NullLogger.d.ts +154 -0
  257. package/dist/logger/NullLogger.d.ts.map +1 -0
  258. package/dist/logger/NullLogger.js +24 -0
  259. package/dist/logger/NullLogger.js.map +1 -0
  260. package/dist/logger/StructuredLogger.d.ts +327 -0
  261. package/dist/logger/StructuredLogger.d.ts.map +1 -0
  262. package/dist/logger/StructuredLogger.js +72 -0
  263. package/dist/logger/StructuredLogger.js.map +1 -0
  264. package/dist/metrics/metrics.impl.d.ts +252 -0
  265. package/dist/metrics/metrics.impl.d.ts.map +1 -0
  266. package/dist/metrics/metrics.impl.js +197 -0
  267. package/dist/metrics/metrics.impl.js.map +1 -0
  268. package/dist/persistence/FileLegacyImport.d.ts +2 -0
  269. package/dist/persistence/FileLegacyImport.d.ts.map +1 -0
  270. package/dist/persistence/FileLegacyImport.js +183 -0
  271. package/dist/persistence/FileLegacyImport.js.map +1 -0
  272. package/dist/persistence/FilePersistence.d.ts +53 -0
  273. package/dist/persistence/FilePersistence.d.ts.map +1 -0
  274. package/dist/persistence/FilePersistence.js +312 -0
  275. package/dist/persistence/FilePersistence.js.map +1 -0
  276. package/dist/persistence/FileSnapshotTypes.d.ts +29 -0
  277. package/dist/persistence/FileSnapshotTypes.d.ts.map +1 -0
  278. package/dist/persistence/FileSnapshotTypes.js +1 -0
  279. package/dist/persistence/FileSnapshotV2.d.ts +377 -0
  280. package/dist/persistence/FileSnapshotV2.d.ts.map +1 -0
  281. package/dist/persistence/FileSnapshotV2.js +124 -0
  282. package/dist/persistence/FileSnapshotV2.js.map +1 -0
  283. package/dist/persistence/FileSnapshotValidation.d.ts +15 -0
  284. package/dist/persistence/FileSnapshotValidation.d.ts.map +1 -0
  285. package/dist/persistence/FileSnapshotValidation.js +64 -0
  286. package/dist/persistence/FileSnapshotValidation.js.map +1 -0
  287. package/dist/persistence/FileWriter.d.ts +30 -0
  288. package/dist/persistence/FileWriter.d.ts.map +1 -0
  289. package/dist/persistence/FileWriter.js +155 -0
  290. package/dist/persistence/FileWriter.js.map +1 -0
  291. package/dist/persistence/MemoryPersistence.d.ts +45 -0
  292. package/dist/persistence/MemoryPersistence.d.ts.map +1 -0
  293. package/dist/persistence/MemoryPersistence.js +180 -0
  294. package/dist/persistence/MemoryPersistence.js.map +1 -0
  295. package/dist/persistence/PersistenceCodec.d.ts +7 -0
  296. package/dist/persistence/PersistenceCodec.d.ts.map +1 -0
  297. package/dist/persistence/PersistenceCodec.js +97 -0
  298. package/dist/persistence/PersistenceCodec.js.map +1 -0
  299. package/dist/persistence/PersistenceErrors.d.ts +23 -0
  300. package/dist/persistence/PersistenceErrors.d.ts.map +1 -0
  301. package/dist/persistence/PersistenceErrors.js +26 -0
  302. package/dist/persistence/PersistenceErrors.js.map +1 -0
  303. package/dist/persistence/PersistenceFactory.d.ts +21 -0
  304. package/dist/persistence/PersistenceFactory.d.ts.map +1 -0
  305. package/dist/persistence/PersistenceFactory.js +28 -0
  306. package/dist/persistence/PersistenceFactory.js.map +1 -0
  307. package/dist/persistence/PersistenceScope.d.ts +42 -0
  308. package/dist/persistence/PersistenceScope.d.ts.map +1 -0
  309. package/dist/persistence/PersistenceScope.js +93 -0
  310. package/dist/persistence/PersistenceScope.js.map +1 -0
  311. package/dist/persistence/SessionScopedPersistence.d.ts +4 -0
  312. package/dist/persistence/SessionScopedPersistence.d.ts.map +1 -0
  313. package/dist/persistence/SessionScopedPersistence.js +9 -0
  314. package/dist/persistence/SessionScopedPersistence.js.map +1 -0
  315. package/dist/persistence/SqliteDriver.d.ts +22 -0
  316. package/dist/persistence/SqliteDriver.d.ts.map +1 -0
  317. package/dist/persistence/SqliteDriver.js +29 -0
  318. package/dist/persistence/SqliteDriver.js.map +1 -0
  319. package/dist/persistence/SqliteLegacyImport.d.ts +14 -0
  320. package/dist/persistence/SqliteLegacyImport.d.ts.map +1 -0
  321. package/dist/persistence/SqliteLegacyImport.js +136 -0
  322. package/dist/persistence/SqliteLegacyImport.js.map +1 -0
  323. package/dist/persistence/SqliteLegacySchema.d.ts +15 -0
  324. package/dist/persistence/SqliteLegacySchema.d.ts.map +1 -0
  325. package/dist/persistence/SqliteLegacySchema.js +72 -0
  326. package/dist/persistence/SqliteLegacySchema.js.map +1 -0
  327. package/dist/persistence/SqlitePayload.d.ts +11 -0
  328. package/dist/persistence/SqlitePayload.d.ts.map +1 -0
  329. package/dist/persistence/SqlitePayload.js +86 -0
  330. package/dist/persistence/SqlitePayload.js.map +1 -0
  331. package/dist/persistence/SqlitePersistence.d.ts +49 -0
  332. package/dist/persistence/SqlitePersistence.d.ts.map +1 -0
  333. package/dist/persistence/SqlitePersistence.js +248 -0
  334. package/dist/persistence/SqlitePersistence.js.map +1 -0
  335. package/dist/persistence/SqliteSchemaV2.d.ts +14 -0
  336. package/dist/persistence/SqliteSchemaV2.d.ts.map +1 -0
  337. package/dist/persistence/SqliteSchemaV2.js +129 -0
  338. package/dist/persistence/SqliteSchemaV2.js.map +1 -0
  339. package/dist/persistence/SqliteSnapshotWriter.d.ts +17 -0
  340. package/dist/persistence/SqliteSnapshotWriter.d.ts.map +1 -0
  341. package/dist/persistence/SqliteSnapshotWriter.js +30 -0
  342. package/dist/persistence/SqliteSnapshotWriter.js.map +1 -0
  343. package/dist/pool/ConnectionPool.d.ts +203 -0
  344. package/dist/pool/ConnectionPool.d.ts.map +1 -0
  345. package/dist/pool/ConnectionPool.js +303 -0
  346. package/dist/pool/ConnectionPool.js.map +1 -0
  347. package/dist/pool/IConnectionPool.d.ts +143 -0
  348. package/dist/pool/IConnectionPool.d.ts.map +1 -0
  349. package/dist/pool/IConnectionPool.js +1 -0
  350. package/dist/pool/PoolErrors.d.ts +11 -0
  351. package/dist/pool/PoolErrors.d.ts.map +1 -0
  352. package/dist/pool/PoolErrors.js +16 -0
  353. package/dist/pool/PoolErrors.js.map +1 -0
  354. package/dist/registry/BaseRegistry.d.ts +219 -0
  355. package/dist/registry/BaseRegistry.d.ts.map +1 -0
  356. package/dist/registry/BaseRegistry.js +215 -0
  357. package/dist/registry/BaseRegistry.js.map +1 -0
  358. package/dist/registry/SkillRegistry.d.ts +67 -0
  359. package/dist/registry/SkillRegistry.d.ts.map +1 -0
  360. package/dist/registry/SkillRegistry.js +87 -0
  361. package/dist/registry/SkillRegistry.js.map +1 -0
  362. package/dist/registry/ToolRegistry.d.ts +70 -0
  363. package/dist/registry/ToolRegistry.d.ts.map +1 -0
  364. package/dist/registry/ToolRegistry.js +96 -0
  365. package/dist/registry/ToolRegistry.js.map +1 -0
  366. package/dist/sanitize.d.ts +164 -0
  367. package/dist/sanitize.d.ts.map +1 -0
  368. package/dist/sanitize.js +100 -0
  369. package/dist/sanitize.js.map +1 -0
  370. package/dist/schema.d.ts +562 -0
  371. package/dist/schema.d.ts.map +1 -0
  372. package/dist/schema.js +251 -0
  373. package/dist/schema.js.map +1 -0
  374. package/dist/transport/BaseTransport.d.ts +166 -0
  375. package/dist/transport/BaseTransport.d.ts.map +1 -0
  376. package/dist/transport/BaseTransport.js +199 -0
  377. package/dist/transport/BaseTransport.js.map +1 -0
  378. package/dist/transport/HttpHelpers.d.ts +53 -0
  379. package/dist/transport/HttpHelpers.d.ts.map +1 -0
  380. package/dist/transport/HttpHelpers.js +44 -0
  381. package/dist/transport/HttpHelpers.js.map +1 -0
  382. package/dist/transport/HttpRequestLifecycle.d.ts +37 -0
  383. package/dist/transport/HttpRequestLifecycle.d.ts.map +1 -0
  384. package/dist/transport/HttpRequestLifecycle.js +87 -0
  385. package/dist/transport/HttpRequestLifecycle.js.map +1 -0
  386. package/dist/transport/HttpTransport.d.ts +140 -0
  387. package/dist/transport/HttpTransport.d.ts.map +1 -0
  388. package/dist/transport/HttpTransport.js +245 -0
  389. package/dist/transport/HttpTransport.js.map +1 -0
  390. package/dist/transport/SseTransport.d.ts +149 -0
  391. package/dist/transport/SseTransport.d.ts.map +1 -0
  392. package/dist/transport/SseTransport.js +470 -0
  393. package/dist/transport/SseTransport.js.map +1 -0
  394. package/dist/transport/StreamableHttpTransport.d.ts +225 -0
  395. package/dist/transport/StreamableHttpTransport.d.ts.map +1 -0
  396. package/dist/transport/StreamableHttpTransport.js +449 -0
  397. package/dist/transport/StreamableHttpTransport.js.map +1 -0
  398. package/dist/types/disposable.d.ts +22 -0
  399. package/dist/types/disposable.d.ts.map +1 -0
  400. package/dist/types/disposable.js +1 -0
  401. package/dist/types/server-config.d.ts +32 -0
  402. package/dist/types/server-config.d.ts.map +1 -0
  403. package/dist/types/server-config.js +1 -0
  404. package/dist/types/skill.d.ts +74 -0
  405. package/dist/types/skill.d.ts.map +1 -0
  406. package/dist/types/skill.js +1 -0
  407. package/dist/types/tool.d.ts +78 -0
  408. package/dist/types/tool.d.ts.map +1 -0
  409. package/dist/types/tool.js +1 -0
  410. package/dist/utils.d.ts +27 -0
  411. package/dist/utils.d.ts.map +1 -0
  412. package/dist/utils.js +6 -0
  413. package/dist/utils.js.map +1 -0
  414. package/dist/watchers/SkillWatcher.d.ts +25 -0
  415. package/dist/watchers/SkillWatcher.d.ts.map +1 -0
  416. package/dist/watchers/SkillWatcher.js +96 -0
  417. package/dist/watchers/SkillWatcher.js.map +1 -0
  418. package/dist/watchers/ToolWatcher.d.ts +24 -0
  419. package/dist/watchers/ToolWatcher.d.ts.map +1 -0
  420. package/dist/watchers/ToolWatcher.js +92 -0
  421. package/dist/watchers/ToolWatcher.js.map +1 -0
  422. package/package.json +106 -0
@@ -0,0 +1,663 @@
1
+ /**
2
+ * Custom error types for the TraceLattice server.
3
+ *
4
+ * This module defines a hierarchy of error classes for handling various
5
+ * error conditions that can occur in the sequential thinking server.
6
+ * All errors extend the base `SequentialThinkingError` class with
7
+ * specific error codes for programmatic handling.
8
+ *
9
+ * @example
10
+ * ```typescript
11
+ * import { ToolNotFoundError, SkillDiscoveryError } from './errors.js';
12
+ *
13
+ * // Throw a tool not found error
14
+ * throw new ToolNotFoundError('my-tool');
15
+ *
16
+ * // Catch and handle specific errors
17
+ * try {
18
+ * await discoverSkills(dir);
19
+ * } catch (error) {
20
+ * if (error instanceof SkillDiscoveryError) {
21
+ * console.error(`Failed to discover skills: ${error.message}`);
22
+ * console.error(`Error code: ${error.code}`);
23
+ * }
24
+ * }
25
+ * ```
26
+ * @module errors
27
+ */
28
+ /**
29
+ * All known error codes as a const object for exhaustive switching.
30
+ */
31
+ export declare const ERROR_CODES: {
32
+ readonly CONFIGURATION_ERROR: "CONFIGURATION_ERROR";
33
+ readonly TOOL_NOT_FOUND: "TOOL_NOT_FOUND";
34
+ readonly SKILL_NOT_FOUND: "SKILL_NOT_FOUND";
35
+ readonly INVALID_THOUGHT: "INVALID_THOUGHT";
36
+ readonly SKILL_DISCOVERY_FAILED: "SKILL_DISCOVERY_FAILED";
37
+ readonly HISTORY_LIMIT_EXCEEDED: "HISTORY_LIMIT_EXCEEDED";
38
+ readonly DUPLICATE_SKILL: "DUPLICATE_SKILL";
39
+ readonly INVALID_SKILL: "INVALID_SKILL";
40
+ readonly DUPLICATE_TOOL: "DUPLICATE_TOOL";
41
+ readonly INVALID_TOOL: "INVALID_TOOL";
42
+ readonly SESSION_NOT_ACTIVE: "SESSION_NOT_ACTIVE";
43
+ readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
44
+ readonly MAX_SESSIONS_REACHED: "MAX_SESSIONS_REACHED";
45
+ readonly POOL_TERMINATED: "POOL_TERMINATED";
46
+ readonly VALIDATION_ERROR: "VALIDATION_ERROR";
47
+ readonly INVALID_EDGE: "INVALID_EDGE";
48
+ readonly CYCLE_DETECTED: "CYCLE_DETECTED";
49
+ readonly SUSPENSION_NOT_FOUND: "SUSPENSION_NOT_FOUND";
50
+ readonly SUSPENSION_EXPIRED: "SUSPENSION_EXPIRED";
51
+ readonly INVALID_TOOL_CALL: "INVALID_TOOL_CALL";
52
+ readonly INVALID_BACKTRACK: "INVALID_BACKTRACK";
53
+ readonly DUPLICATE_SUMMARY: "DUPLICATE_SUMMARY";
54
+ readonly UNKNOWN_TOOL: "UNKNOWN_TOOL";
55
+ readonly LOCK_TIMEOUT: "LOCK_TIMEOUT";
56
+ readonly CLI_SHUTDOWN_TIMEOUT: "CLI_SHUTDOWN_TIMEOUT";
57
+ readonly SESSION_ACCESS_DENIED: "SESSION_ACCESS_DENIED";
58
+ readonly SESSION_LIFECYCLE_CLOSED: "SESSION_LIFECYCLE_CLOSED";
59
+ readonly PERSISTENCE_OWNERSHIP: "PERSISTENCE_OWNERSHIP";
60
+ readonly PERSISTENCE_CORRUPTION: "PERSISTENCE_CORRUPTION";
61
+ readonly PERSISTENCE_PUBLICATION: "PERSISTENCE_PUBLICATION";
62
+ readonly PERSISTENCE_CLOSED: "PERSISTENCE_CLOSED";
63
+ readonly PERSISTENCE_DRAIN: "PERSISTENCE_DRAIN";
64
+ readonly PERSISTENCE_SESSION_ADMISSION_CLOSED: "PERSISTENCE_SESSION_ADMISSION_CLOSED";
65
+ readonly PERSISTENCE_SESSION_BARRIER_REENTRANCY: "PERSISTENCE_SESSION_BARRIER_REENTRANCY";
66
+ readonly ASYNC_RESET_REQUIRED: "ASYNC_RESET_REQUIRED";
67
+ readonly PERSISTENCE_CAPABILITY_UNSUPPORTED: "PERSISTENCE_CAPABILITY_UNSUPPORTED";
68
+ readonly PERSISTENCE_SCOPE_MISMATCH: "PERSISTENCE_SCOPE_MISMATCH";
69
+ readonly PERSISTENCE_UNAVAILABLE: "PERSISTENCE_UNAVAILABLE";
70
+ readonly PERSISTENCE_COMPATIBILITY: "PERSISTENCE_COMPATIBILITY";
71
+ readonly PERSISTENCE_IMPORT_REQUIRED: "PERSISTENCE_IMPORT_REQUIRED";
72
+ readonly PERSISTENCE_LEGACY_AMBIGUITY: "PERSISTENCE_LEGACY_AMBIGUITY";
73
+ };
74
+ export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
75
+ /**
76
+ * All known warning codes as a const object.
77
+ * Warnings are non-fatal advisory signals returned alongside successful results.
78
+ */
79
+ export declare const WARNING_CODES: {
80
+ readonly TOTAL_THOUGHTS_ADJUSTED: "TOTAL_THOUGHTS_ADJUSTED";
81
+ };
82
+ export type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];
83
+ /**
84
+ * Base error class for all Sequential Thinking server errors.
85
+ *
86
+ * This error extends the native `Error` class and adds a `code` property
87
+ * for programmatic error identification and handling. All specific error
88
+ * types in the system extend this base class.
89
+ *
90
+ * @remarks
91
+ * **Error Codes:**
92
+ * - `TOOL_NOT_FOUND` - A requested tool was not found
93
+ * - `SKILL_NOT_FOUND` - A requested skill was not found
94
+ * - `INVALID_THOUGHT` - Thought validation failed
95
+ * - `SKILL_DISCOVERY_FAILED` - Skill discovery operation failed
96
+ * - `HISTORY_LIMIT_EXCEEDED` - History size limit was exceeded
97
+ * - `INVALID_EDGE` - An invalid edge operation was attempted
98
+ *
99
+ * @example
100
+ * ```typescript
101
+ * // Throw a custom sequential thinking error
102
+ * throw new SequentialThinkingError('Custom error message', 'CUSTOM_CODE');
103
+ *
104
+ * // Check if an error is a SequentialThinkingError
105
+ * if (error instanceof SequentialThinkingError) {
106
+ * console.error(`Error [${error.code}]: ${error.message}`);
107
+ * }
108
+ * ```
109
+ */
110
+ export declare class SequentialThinkingError extends Error {
111
+ /** The error code for programmatic identification. */
112
+ readonly code: ErrorCode;
113
+ /**
114
+ * Creates a new SequentialThinkingError.
115
+ *
116
+ * @param message - Human-readable error message
117
+ * @param code - Error code for programmatic handling
118
+ *
119
+ * @example
120
+ * ```typescript
121
+ * const error = new SequentialThinkingError(
122
+ * 'Something went wrong',
123
+ * 'CUSTOM_ERROR'
124
+ * );
125
+ * console.log(error.code); // 'CUSTOM_ERROR'
126
+ * ```
127
+ */
128
+ constructor(message: string, code: ErrorCode);
129
+ }
130
+ export declare class ConfigurationError extends SequentialThinkingError {
131
+ constructor(message: string);
132
+ }
133
+ /**
134
+ * Error thrown when a requested tool is not found in the registry.
135
+ *
136
+ * This error is thrown when attempting to retrieve, update, or delete
137
+ * a tool that doesn't exist in the tool registry.
138
+ *
139
+ * @example
140
+ * ```typescript
141
+ * const tool = registry.getTool('non-existent-tool');
142
+ * if (!tool) {
143
+ * throw new ToolNotFoundError('non-existent-tool');
144
+ * }
145
+ * ```
146
+ */
147
+ export declare class ToolNotFoundError extends SequentialThinkingError {
148
+ /**
149
+ * Creates a new ToolNotFoundError.
150
+ *
151
+ * @param toolName - The name of the tool that was not found
152
+ * @param action - Optional action being performed (e.g., 'remove', 'update')
153
+ *
154
+ * @example
155
+ * ```typescript
156
+ * throw new ToolNotFoundError('my-custom-tool');
157
+ * // Error: tool 'my-custom-tool' not found
158
+ *
159
+ * throw new ToolNotFoundError('my-custom-tool', 'remove');
160
+ * // Error: tool 'my-custom-tool' not found, cannot remove
161
+ * // Code: TOOL_NOT_FOUND
162
+ * ```
163
+ */
164
+ constructor(toolName: string, action?: string);
165
+ }
166
+ /**
167
+ * Error thrown when a requested skill is not found in the registry.
168
+ *
169
+ * This error is thrown when attempting to retrieve, update, or delete
170
+ * a skill that doesn't exist in the skill registry.
171
+ *
172
+ * @example
173
+ * ```typescript
174
+ * const skill = registry.getSkill('non-existent-skill');
175
+ * if (!skill) {
176
+ * throw new SkillNotFoundError('non-existent-skill');
177
+ * }
178
+ * ```
179
+ */
180
+ export declare class SkillNotFoundError extends SequentialThinkingError {
181
+ /**
182
+ * Creates a new SkillNotFoundError.
183
+ *
184
+ * @param skillName - The name of the skill that was not found
185
+ * @param action - Optional action being performed (e.g., 'remove', 'update')
186
+ *
187
+ * @example
188
+ * ```typescript
189
+ * throw new SkillNotFoundError('my-custom-skill');
190
+ * // Error: skill 'my-custom-skill' not found
191
+ *
192
+ * throw new SkillNotFoundError('my-custom-skill', 'remove');
193
+ * // Error: skill 'my-custom-skill' not found, cannot remove
194
+ * // Code: SKILL_NOT_FOUND
195
+ * ```
196
+ */
197
+ constructor(skillName: string, action?: string);
198
+ }
199
+ /**
200
+ * Error thrown when thought validation fails.
201
+ *
202
+ * This error is thrown when a thought fails validation, typically due to
203
+ * invalid values, missing required fields, or constraint violations.
204
+ *
205
+ * @example
206
+ * ```typescript
207
+ * // Validate thought number
208
+ * if (thought.thought_number < 1) {
209
+ * throw new InvalidThoughtError(thought.thought_number, 'thought_number must be >= 1');
210
+ * }
211
+ * ```
212
+ */
213
+ export declare class InvalidThoughtError extends SequentialThinkingError {
214
+ /**
215
+ * Creates a new InvalidThoughtError.
216
+ *
217
+ * @param thoughtNumber - The thought number that failed validation
218
+ * @param reason - Human-readable explanation of why validation failed
219
+ *
220
+ * @example
221
+ * ```typescript
222
+ * throw new InvalidThoughtError(5, 'thought_number exceeds total_thoughts');
223
+ * // Error: Invalid thought 5: thought_number exceeds total_thoughts
224
+ * // Code: INVALID_THOUGHT
225
+ * ```
226
+ */
227
+ constructor(thoughtNumber: number, reason: string);
228
+ }
229
+ /**
230
+ * Error thrown when skill discovery fails.
231
+ *
232
+ * This error is thrown when the skill discovery process encounters an issue,
233
+ * such as filesystem errors, invalid skill files, or parsing failures.
234
+ *
235
+ * @remarks
236
+ * The original error that caused the discovery failure is preserved in the
237
+ * `cause` property for debugging purposes.
238
+ *
239
+ * @example
240
+ * ```typescript
241
+ * try {
242
+ * await discoverSkills('./skills');
243
+ * } catch (error) {
244
+ * throw new SkillDiscoveryError('./skills', error as Error);
245
+ * }
246
+ * ```
247
+ */
248
+ export declare class SkillDiscoveryError extends SequentialThinkingError {
249
+ /** The underlying error that caused the discovery failure. */
250
+ readonly cause: Error;
251
+ /**
252
+ * Creates a new SkillDiscoveryError.
253
+ *
254
+ * @param directory - The directory where discovery failed
255
+ * @param cause - The underlying error that caused the failure
256
+ *
257
+ * @example
258
+ * ```typescript
259
+ * try {
260
+ * const skills = await loadSkills('./invalid-directory');
261
+ * } catch (error) {
262
+ * throw new SkillDiscoveryError('./invalid-directory', error as Error);
263
+ * }
264
+ * ```
265
+ */
266
+ constructor(directory: string, cause: Error);
267
+ }
268
+ /**
269
+ * Error thrown when history size exceeds the configured limit.
270
+ *
271
+ * This error is thrown when an operation would cause the history size
272
+ * to exceed the maximum configured size limit.
273
+ *
274
+ * @example
275
+ * ```typescript
276
+ * if (history.length >= maxSize) {
277
+ * throw new HistoryLimitExceededError(history.length, maxSize);
278
+ * }
279
+ * ```
280
+ */
281
+ export declare class HistoryLimitExceededError extends SequentialThinkingError {
282
+ /**
283
+ * Creates a new HistoryLimitExceededError.
284
+ *
285
+ * @param currentSize - The current history size
286
+ * @param maxSize - The maximum allowed size
287
+ *
288
+ * @example
289
+ * ```typescript
290
+ * throw new HistoryLimitExceededError(1500, 1000);
291
+ * // Error: History size 1500 exceeds limit 1000
292
+ * // Code: HISTORY_LIMIT_EXCEEDED
293
+ * ```
294
+ */
295
+ constructor(currentSize: number, maxSize: number);
296
+ }
297
+ /**
298
+ * Error thrown when attempting to add a skill that already exists.
299
+ *
300
+ * This error is thrown when trying to register a skill with a name that
301
+ * is already present in the skill registry.
302
+ *
303
+ * @example
304
+ * ```typescript
305
+ * if (registry.hasSkill(skill.name)) {
306
+ * throw new DuplicateSkillError(skill.name);
307
+ * }
308
+ * ```
309
+ */
310
+ export declare class DuplicateSkillError extends SequentialThinkingError {
311
+ /**
312
+ * Creates a new DuplicateSkillError.
313
+ *
314
+ * @param skillName - The name of the duplicate skill
315
+ *
316
+ * @example
317
+ * ```typescript
318
+ * throw new DuplicateSkillError('my-skill');
319
+ * // Error: skill 'my-skill' already exists
320
+ * // Code: DUPLICATE_SKILL
321
+ * ```
322
+ */
323
+ constructor(skillName: string);
324
+ }
325
+ /**
326
+ * Error thrown when a skill has invalid data.
327
+ *
328
+ * This error is thrown when a skill fails validation, typically due to
329
+ * missing required fields or invalid values.
330
+ *
331
+ * @example
332
+ * ```typescript
333
+ * if (!skill.name) {
334
+ * throw new InvalidSkillError('Skill must have a valid name');
335
+ * }
336
+ * ```
337
+ */
338
+ export declare class InvalidSkillError extends SequentialThinkingError {
339
+ /**
340
+ * Creates a new InvalidSkillError.
341
+ *
342
+ * @param reason - The reason for the validation failure
343
+ *
344
+ * @example
345
+ * ```typescript
346
+ * throw new InvalidSkillError('Skill must have a valid name');
347
+ * // Error: Invalid skill: Skill must have a valid name
348
+ * // Code: INVALID_SKILL
349
+ * ```
350
+ */
351
+ constructor(reason: string);
352
+ }
353
+ /**
354
+ * Error thrown when attempting to add a tool that already exists.
355
+ *
356
+ * This error is thrown when trying to register a tool with a name that
357
+ * is already present in the tool registry.
358
+ *
359
+ * @example
360
+ * ```typescript
361
+ * if (registry.hasTool(tool.name)) {
362
+ * throw new DuplicateToolError(tool.name);
363
+ * }
364
+ * ```
365
+ */
366
+ export declare class DuplicateToolError extends SequentialThinkingError {
367
+ /**
368
+ * Creates a new DuplicateToolError.
369
+ *
370
+ * @param toolName - The name of the duplicate tool
371
+ *
372
+ * @example
373
+ * ```typescript
374
+ * throw new DuplicateToolError('my-tool');
375
+ * // Error: tool 'my-tool' already exists
376
+ * // Code: DUPLICATE_TOOL
377
+ * ```
378
+ */
379
+ constructor(toolName: string);
380
+ }
381
+ /**
382
+ * Error thrown when a tool has invalid data.
383
+ *
384
+ * This error is thrown when a tool fails validation, typically due to
385
+ * missing required fields or invalid values.
386
+ *
387
+ * @example
388
+ * ```typescript
389
+ * if (!tool.name) {
390
+ * throw new InvalidToolError('Tool must have a valid name');
391
+ * }
392
+ * ```
393
+ */
394
+ export declare class InvalidToolError extends SequentialThinkingError {
395
+ /**
396
+ * Creates a new InvalidToolError.
397
+ *
398
+ * @param reason - The reason for the validation failure
399
+ *
400
+ * @example
401
+ * ```typescript
402
+ * throw new InvalidToolError('Tool must have a valid name');
403
+ * // Error: Invalid tool: Tool must have a valid name
404
+ * // Code: INVALID_TOOL
405
+ * ```
406
+ */
407
+ constructor(reason: string);
408
+ }
409
+ /**
410
+ * Error thrown when the maximum number of sessions has been reached.
411
+ *
412
+ * This error is thrown when trying to create a new session when the
413
+ * pool has reached its configured maximum session limit.
414
+ *
415
+ * @example
416
+ * ```typescript
417
+ * if (pool.sessionCount >= pool.maxSessions) {
418
+ * throw new MaxSessionsReachedError(pool.maxSessions);
419
+ * }
420
+ * ```
421
+ */
422
+ export declare class MaxSessionsReachedError extends SequentialThinkingError {
423
+ /**
424
+ * Creates a new MaxSessionsReachedError.
425
+ *
426
+ * @param maxSessions - The maximum number of sessions allowed
427
+ *
428
+ * @example
429
+ * ```typescript
430
+ * throw new MaxSessionsReachedError(100);
431
+ * // Error: Max sessions (100) reached. Wait for a session to close or increase maxSessions.
432
+ * // Code: MAX_SESSIONS_REACHED
433
+ * ```
434
+ */
435
+ constructor(maxSessions: number);
436
+ }
437
+ /**
438
+ * Error thrown when attempting to use a terminated connection pool.
439
+ *
440
+ * This error is thrown when trying to create sessions or process requests
441
+ * after the connection pool has been terminated.
442
+ *
443
+ * @example
444
+ * ```typescript
445
+ * if (pool.isTerminated) {
446
+ * throw new PoolTerminatedError();
447
+ * }
448
+ * ```
449
+ */
450
+ export declare class PoolTerminatedError extends SequentialThinkingError {
451
+ /**
452
+ * Creates a new PoolTerminatedError.
453
+ *
454
+ * @example
455
+ * ```typescript
456
+ * throw new PoolTerminatedError();
457
+ * // Error: ConnectionPool has been terminated
458
+ * // Code: POOL_TERMINATED
459
+ * ```
460
+ */
461
+ constructor();
462
+ }
463
+ /**
464
+ * Error thrown when input validation fails due to invalid or malicious data.
465
+ *
466
+ * This error is thrown when user input fails security or format validation,
467
+ * such as path traversal attempts or invalid identifier formats.
468
+ *
469
+ * @example
470
+ * ```typescript
471
+ * if (!BRANCH_ID_PATTERN.test(branchId)) {
472
+ * throw new ValidationError('branchId', 'Invalid format');
473
+ * }
474
+ * ```
475
+ */
476
+ export declare class ValidationError extends SequentialThinkingError {
477
+ /** The field that failed validation. */
478
+ readonly field: string;
479
+ constructor(field: string, reason: string);
480
+ }
481
+ /**
482
+ * Error thrown when an invalid edge operation is attempted.
483
+ *
484
+ * This error is thrown when attempting to add an edge that violates
485
+ * structural invariants of the thought DAG, such as a self-edge
486
+ * (where `from` and `to` reference the same thought).
487
+ *
488
+ * @example
489
+ * ```typescript
490
+ * if (edge.from === edge.to) {
491
+ * throw new InvalidEdgeError(
492
+ * `Self-edge not allowed: from and to are the same (${edge.from})`
493
+ * );
494
+ * }
495
+ * ```
496
+ */
497
+ export declare class InvalidEdgeError extends SequentialThinkingError {
498
+ /**
499
+ * Creates a new InvalidEdgeError.
500
+ *
501
+ * @param message - Human-readable explanation of the invalid edge
502
+ *
503
+ * @example
504
+ * ```typescript
505
+ * throw new InvalidEdgeError('Self-edge not allowed: from and to are the same (t1)');
506
+ * // Code: INVALID_EDGE
507
+ * ```
508
+ */
509
+ constructor(message: string);
510
+ }
511
+ /**
512
+ * Error thrown when a cycle is detected during graph traversal.
513
+ *
514
+ * This error is thrown by graph algorithms (such as topological sort)
515
+ * when the thought DAG contains a cycle, violating the acyclic invariant.
516
+ *
517
+ * @example
518
+ * ```typescript
519
+ * try {
520
+ * const order = graphView.topological(sessionId);
521
+ * } catch (error) {
522
+ * if (error instanceof CycleDetectedError) {
523
+ * console.error('Cycle in thought graph:', error.message);
524
+ * }
525
+ * }
526
+ * ```
527
+ */
528
+ export declare class CycleDetectedError extends SequentialThinkingError {
529
+ /**
530
+ * Creates a new CycleDetectedError.
531
+ *
532
+ * @param message - Human-readable explanation of the cycle
533
+ *
534
+ * @example
535
+ * ```typescript
536
+ * throw new CycleDetectedError('Cycle detected in session s1');
537
+ * // Code: CYCLE_DETECTED
538
+ * ```
539
+ */
540
+ constructor(message: string);
541
+ }
542
+ /**
543
+ * Error thrown when a suspension record is not found.
544
+ *
545
+ * This error is thrown when attempting to resume a tool interleave
546
+ * suspension that does not exist in the suspension store.
547
+ */
548
+ export declare class SuspensionNotFoundError extends SequentialThinkingError {
549
+ constructor(message: string);
550
+ }
551
+ /**
552
+ * Error thrown when a suspension record has expired.
553
+ *
554
+ * This error is thrown when attempting to resume a tool interleave
555
+ * suspension whose TTL has elapsed.
556
+ */
557
+ export declare class SuspensionExpiredError extends SequentialThinkingError {
558
+ constructor(message: string);
559
+ }
560
+ /**
561
+ * Error thrown when a tool call payload is invalid.
562
+ *
563
+ * This error is thrown when a tool interleave invocation has malformed
564
+ * arguments, missing identifiers, or otherwise fails validation.
565
+ */
566
+ export declare class InvalidToolCallError extends SequentialThinkingError {
567
+ constructor(message: string);
568
+ }
569
+ /**
570
+ * Error thrown when a backtrack operation is invalid.
571
+ *
572
+ * This error is thrown when an attempt to backtrack the reasoning
573
+ * chain references an unreachable thought or violates DAG invariants.
574
+ */
575
+ export declare class InvalidBacktrackError extends SequentialThinkingError {
576
+ constructor(message: string);
577
+ }
578
+ /**
579
+ * Error thrown when a tool_call references a tool not registered with the server.
580
+ *
581
+ * Acts as an allowlist gate: only tools registered in the ToolRegistry may be
582
+ * invoked through tool interleave. Prevents arbitrary tool name injection.
583
+ */
584
+ export declare class UnknownToolError extends SequentialThinkingError {
585
+ readonly toolName: string;
586
+ constructor(toolName: string, message?: string);
587
+ }
588
+ /** Error thrown when the CLI's complete shutdown exceeds its outer deadline. */
589
+ export declare class CliShutdownTimeoutError extends SequentialThinkingError {
590
+ readonly timeoutMs: number;
591
+ constructor(timeoutMs: number);
592
+ }
593
+ export declare class PersistenceOwnershipError extends SequentialThinkingError {
594
+ readonly canonicalDataDir: string;
595
+ readonly lockPath: string;
596
+ readonly cause: unknown;
597
+ constructor(canonicalDataDir: string, lockPath: string, cause: unknown);
598
+ }
599
+ export declare class PersistenceCorruptionError extends SequentialThinkingError {
600
+ readonly path: string;
601
+ readonly cause: unknown;
602
+ constructor(path: string, cause: unknown);
603
+ }
604
+ /** Error raised when startup cannot read from an unhealthy persistence backend. */
605
+ export declare class PersistenceUnavailableError extends SequentialThinkingError {
606
+ constructor();
607
+ }
608
+ export type PersistencePublicationStage = 'temporary-write' | 'atomic-replacement' | 'cleanup';
609
+ export declare class PersistencePublicationError extends SequentialThinkingError {
610
+ readonly path: string;
611
+ readonly stage: PersistencePublicationStage;
612
+ readonly cause: unknown;
613
+ constructor(path: string, stage: PersistencePublicationStage, cause: unknown);
614
+ }
615
+ export declare class PersistenceClosedError extends SequentialThinkingError {
616
+ readonly dataDir: string;
617
+ constructor(dataDir: string);
618
+ }
619
+ /** Error raised for well-formed but unsupported or drifted persisted data. */
620
+ export declare class PersistenceCompatibilityError extends SequentialThinkingError {
621
+ readonly sourcePath: string;
622
+ readonly detail: string;
623
+ readonly cause: unknown;
624
+ constructor(sourcePath: string, detail: string, cause?: unknown);
625
+ }
626
+ /** Error raised when legacy files require an explicit one-way import. */
627
+ export declare class PersistenceImportRequiredError extends SequentialThinkingError {
628
+ readonly sourcePath: string;
629
+ readonly legacyArtifacts: readonly string[];
630
+ constructor(sourcePath: string, legacyArtifacts: readonly string[]);
631
+ }
632
+ /** Error raised when legacy bytes do not identify one durable namespace. */
633
+ export declare class PersistenceLegacyAmbiguityError extends SequentialThinkingError {
634
+ readonly sourcePath: string;
635
+ readonly detail: string;
636
+ constructor(sourcePath: string, detail: string);
637
+ }
638
+ /**
639
+ * Type guard to check if an error has a specific error code.
640
+ */
641
+ export declare function isErrorCode<C extends ErrorCode>(err: unknown, code: C): err is SequentialThinkingError & {
642
+ readonly code: C;
643
+ };
644
+ /**
645
+ * Extract a human-readable message from an unknown error value.
646
+ *
647
+ * Standardizes the common `error instanceof Error ? error.message : String(error)`
648
+ * pattern used in catch blocks across the codebase.
649
+ *
650
+ * @param error - The unknown error value to extract a message from
651
+ * @returns The error message string
652
+ *
653
+ * @example
654
+ * ```typescript
655
+ * try {
656
+ * await doSomething();
657
+ * } catch (error) {
658
+ * logger.error('Failed', { error: getErrorMessage(error) });
659
+ * }
660
+ * ```
661
+ */
662
+ export declare function getErrorMessage(error: unknown): string;
663
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}