@principal-ai/subsystems-core 0.29.0 → 0.30.0

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 (553) hide show
  1. package/README.md +15 -110
  2. package/dist/index.d.ts +7 -75
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +21 -205
  5. package/dist/index.js.map +1 -1
  6. package/dist/node.d.ts +7 -62
  7. package/dist/node.d.ts.map +1 -1
  8. package/dist/node.js +11 -146
  9. package/dist/node.js.map +1 -1
  10. package/dist/types/index.d.ts +3 -348
  11. package/dist/types/index.d.ts.map +1 -1
  12. package/dist/types/index.js +3 -19
  13. package/dist/types/index.js.map +1 -1
  14. package/package.json +7 -24
  15. package/src/index.ts +7 -580
  16. package/src/node.ts +21 -262
  17. package/src/types/index.ts +3 -456
  18. package/dist/ConfigurationLoader.d.ts +0 -76
  19. package/dist/ConfigurationLoader.d.ts.map +0 -1
  20. package/dist/ConfigurationLoader.js +0 -148
  21. package/dist/ConfigurationLoader.js.map +0 -1
  22. package/dist/ConfigurationValidator.d.ts +0 -31
  23. package/dist/ConfigurationValidator.d.ts.map +0 -1
  24. package/dist/ConfigurationValidator.js +0 -239
  25. package/dist/ConfigurationValidator.js.map +0 -1
  26. package/dist/EventProcessor.d.ts +0 -49
  27. package/dist/EventProcessor.d.ts.map +0 -1
  28. package/dist/EventProcessor.js +0 -220
  29. package/dist/EventProcessor.js.map +0 -1
  30. package/dist/EventRecorderService.d.ts +0 -305
  31. package/dist/EventRecorderService.d.ts.map +0 -1
  32. package/dist/EventRecorderService.js +0 -467
  33. package/dist/EventRecorderService.js.map +0 -1
  34. package/dist/LibraryLoader.d.ts +0 -65
  35. package/dist/LibraryLoader.d.ts.map +0 -1
  36. package/dist/LibraryLoader.js +0 -197
  37. package/dist/LibraryLoader.js.map +0 -1
  38. package/dist/PathBasedEventProcessor.d.ts +0 -77
  39. package/dist/PathBasedEventProcessor.d.ts.map +0 -1
  40. package/dist/PathBasedEventProcessor.js +0 -136
  41. package/dist/PathBasedEventProcessor.js.map +0 -1
  42. package/dist/SessionManager.d.ts +0 -194
  43. package/dist/SessionManager.d.ts.map +0 -1
  44. package/dist/SessionManager.js +0 -302
  45. package/dist/SessionManager.js.map +0 -1
  46. package/dist/ValidationEngine.d.ts +0 -31
  47. package/dist/ValidationEngine.d.ts.map +0 -1
  48. package/dist/ValidationEngine.js +0 -162
  49. package/dist/ValidationEngine.js.map +0 -1
  50. package/dist/auxiliary/AuxiliaryManifestValidator.d.ts +0 -41
  51. package/dist/auxiliary/AuxiliaryManifestValidator.d.ts.map +0 -1
  52. package/dist/auxiliary/AuxiliaryManifestValidator.js +0 -100
  53. package/dist/auxiliary/AuxiliaryManifestValidator.js.map +0 -1
  54. package/dist/auxiliary/index.d.ts +0 -9
  55. package/dist/auxiliary/index.d.ts.map +0 -1
  56. package/dist/auxiliary/index.js +0 -14
  57. package/dist/auxiliary/index.js.map +0 -1
  58. package/dist/auxiliary/validateAreaScopeDisjoint.d.ts +0 -24
  59. package/dist/auxiliary/validateAreaScopeDisjoint.d.ts.map +0 -1
  60. package/dist/auxiliary/validateAreaScopeDisjoint.js +0 -61
  61. package/dist/auxiliary/validateAreaScopeDisjoint.js.map +0 -1
  62. package/dist/cli/codegen.d.ts +0 -41
  63. package/dist/cli/codegen.d.ts.map +0 -1
  64. package/dist/cli/codegen.js +0 -257
  65. package/dist/cli/codegen.js.map +0 -1
  66. package/dist/codegen/type-generator.d.ts +0 -123
  67. package/dist/codegen/type-generator.d.ts.map +0 -1
  68. package/dist/codegen/type-generator.js +0 -433
  69. package/dist/codegen/type-generator.js.map +0 -1
  70. package/dist/codegen/usage-example.d.ts +0 -103
  71. package/dist/codegen/usage-example.d.ts.map +0 -1
  72. package/dist/codegen/usage-example.js +0 -258
  73. package/dist/codegen/usage-example.js.map +0 -1
  74. package/dist/dashboard/DashboardValidator.d.ts +0 -85
  75. package/dist/dashboard/DashboardValidator.d.ts.map +0 -1
  76. package/dist/dashboard/DashboardValidator.js +0 -775
  77. package/dist/dashboard/DashboardValidator.js.map +0 -1
  78. package/dist/dashboard/index.d.ts +0 -6
  79. package/dist/dashboard/index.d.ts.map +0 -1
  80. package/dist/dashboard/index.js +0 -10
  81. package/dist/dashboard/index.js.map +0 -1
  82. package/dist/discovery/CanvasDiscovery.d.ts +0 -160
  83. package/dist/discovery/CanvasDiscovery.d.ts.map +0 -1
  84. package/dist/discovery/CanvasDiscovery.js +0 -865
  85. package/dist/discovery/CanvasDiscovery.js.map +0 -1
  86. package/dist/discovery/CanvasFileManifest.d.ts +0 -86
  87. package/dist/discovery/CanvasFileManifest.d.ts.map +0 -1
  88. package/dist/discovery/CanvasFileManifest.js +0 -338
  89. package/dist/discovery/CanvasFileManifest.js.map +0 -1
  90. package/dist/discovery/LibraryDiscovery.d.ts +0 -108
  91. package/dist/discovery/LibraryDiscovery.d.ts.map +0 -1
  92. package/dist/discovery/LibraryDiscovery.js +0 -263
  93. package/dist/discovery/LibraryDiscovery.js.map +0 -1
  94. package/dist/discovery/types.d.ts +0 -403
  95. package/dist/discovery/types.d.ts.map +0 -1
  96. package/dist/discovery/types.js +0 -6
  97. package/dist/discovery/types.js.map +0 -1
  98. package/dist/events/EventsCanvasValidator.d.ts +0 -139
  99. package/dist/events/EventsCanvasValidator.d.ts.map +0 -1
  100. package/dist/events/EventsCanvasValidator.js +0 -281
  101. package/dist/events/EventsCanvasValidator.js.map +0 -1
  102. package/dist/events/NamespacePathIndex.d.ts +0 -61
  103. package/dist/events/NamespacePathIndex.d.ts.map +0 -1
  104. package/dist/events/NamespacePathIndex.js +0 -74
  105. package/dist/events/NamespacePathIndex.js.map +0 -1
  106. package/dist/events/OtelEventPathsValidator.d.ts +0 -75
  107. package/dist/events/OtelEventPathsValidator.d.ts.map +0 -1
  108. package/dist/events/OtelEventPathsValidator.js +0 -126
  109. package/dist/events/OtelEventPathsValidator.js.map +0 -1
  110. package/dist/events/ScopeEventsValidator.d.ts +0 -68
  111. package/dist/events/ScopeEventsValidator.d.ts.map +0 -1
  112. package/dist/events/ScopeEventsValidator.js +0 -91
  113. package/dist/events/ScopeEventsValidator.js.map +0 -1
  114. package/dist/events/index.d.ts +0 -9
  115. package/dist/events/index.d.ts.map +0 -1
  116. package/dist/events/index.js +0 -12
  117. package/dist/events/index.js.map +0 -1
  118. package/dist/events/path-helpers.d.ts +0 -33
  119. package/dist/events/path-helpers.d.ts.map +0 -1
  120. package/dist/events/path-helpers.js +0 -59
  121. package/dist/events/path-helpers.js.map +0 -1
  122. package/dist/execution/ExecutionLoader.d.ts +0 -135
  123. package/dist/execution/ExecutionLoader.d.ts.map +0 -1
  124. package/dist/execution/ExecutionLoader.js +0 -266
  125. package/dist/execution/ExecutionLoader.js.map +0 -1
  126. package/dist/execution/ExecutionValidator.d.ts +0 -94
  127. package/dist/execution/ExecutionValidator.d.ts.map +0 -1
  128. package/dist/execution/ExecutionValidator.js +0 -503
  129. package/dist/execution/ExecutionValidator.js.map +0 -1
  130. package/dist/generated/graph-converter-execution.types.d.ts +0 -177
  131. package/dist/generated/graph-converter-execution.types.d.ts.map +0 -1
  132. package/dist/generated/graph-converter-execution.types.js +0 -12
  133. package/dist/generated/graph-converter-execution.types.js.map +0 -1
  134. package/dist/helpers/GraphInstrumentationHelper.d.ts +0 -93
  135. package/dist/helpers/GraphInstrumentationHelper.d.ts.map +0 -1
  136. package/dist/helpers/GraphInstrumentationHelper.js +0 -252
  137. package/dist/helpers/GraphInstrumentationHelper.js.map +0 -1
  138. package/dist/matchers/SpanMatcher.d.ts +0 -107
  139. package/dist/matchers/SpanMatcher.d.ts.map +0 -1
  140. package/dist/matchers/SpanMatcher.js +0 -274
  141. package/dist/matchers/SpanMatcher.js.map +0 -1
  142. package/dist/orchestration/TraceOrchestrator.d.ts +0 -71
  143. package/dist/orchestration/TraceOrchestrator.d.ts.map +0 -1
  144. package/dist/orchestration/TraceOrchestrator.js +0 -416
  145. package/dist/orchestration/TraceOrchestrator.js.map +0 -1
  146. package/dist/parsers/OtlpTraceParser.d.ts +0 -131
  147. package/dist/parsers/OtlpTraceParser.d.ts.map +0 -1
  148. package/dist/parsers/OtlpTraceParser.js +0 -310
  149. package/dist/parsers/OtlpTraceParser.js.map +0 -1
  150. package/dist/registry/CompositeRegistry.d.ts +0 -71
  151. package/dist/registry/CompositeRegistry.d.ts.map +0 -1
  152. package/dist/registry/CompositeRegistry.js +0 -113
  153. package/dist/registry/CompositeRegistry.js.map +0 -1
  154. package/dist/registry/EventRegistry.d.ts +0 -79
  155. package/dist/registry/EventRegistry.d.ts.map +0 -1
  156. package/dist/registry/EventRegistry.js +0 -165
  157. package/dist/registry/EventRegistry.js.map +0 -1
  158. package/dist/registry/LocalRegistry.d.ts +0 -111
  159. package/dist/registry/LocalRegistry.d.ts.map +0 -1
  160. package/dist/registry/LocalRegistry.js +0 -335
  161. package/dist/registry/LocalRegistry.js.map +0 -1
  162. package/dist/registry/RemoteRegistry.d.ts +0 -122
  163. package/dist/registry/RemoteRegistry.d.ts.map +0 -1
  164. package/dist/registry/RemoteRegistry.js +0 -399
  165. package/dist/registry/RemoteRegistry.js.map +0 -1
  166. package/dist/registry/VersionRegistry.d.ts +0 -51
  167. package/dist/registry/VersionRegistry.d.ts.map +0 -1
  168. package/dist/registry/VersionRegistry.js +0 -105
  169. package/dist/registry/VersionRegistry.js.map +0 -1
  170. package/dist/rules/config.d.ts +0 -57
  171. package/dist/rules/config.d.ts.map +0 -1
  172. package/dist/rules/config.js +0 -382
  173. package/dist/rules/config.js.map +0 -1
  174. package/dist/rules/engine.d.ts +0 -70
  175. package/dist/rules/engine.d.ts.map +0 -1
  176. package/dist/rules/engine.js +0 -373
  177. package/dist/rules/engine.js.map +0 -1
  178. package/dist/rules/implementations/connection-type-references.d.ts +0 -7
  179. package/dist/rules/implementations/connection-type-references.d.ts.map +0 -1
  180. package/dist/rules/implementations/connection-type-references.js +0 -107
  181. package/dist/rules/implementations/connection-type-references.js.map +0 -1
  182. package/dist/rules/implementations/dead-end-states.d.ts +0 -17
  183. package/dist/rules/implementations/dead-end-states.d.ts.map +0 -1
  184. package/dist/rules/implementations/dead-end-states.js +0 -75
  185. package/dist/rules/implementations/dead-end-states.js.map +0 -1
  186. package/dist/rules/implementations/index.d.ts +0 -23
  187. package/dist/rules/implementations/index.d.ts.map +0 -1
  188. package/dist/rules/implementations/index.js +0 -73
  189. package/dist/rules/implementations/index.js.map +0 -1
  190. package/dist/rules/implementations/minimum-node-sources.d.ts +0 -24
  191. package/dist/rules/implementations/minimum-node-sources.d.ts.map +0 -1
  192. package/dist/rules/implementations/minimum-node-sources.js +0 -59
  193. package/dist/rules/implementations/minimum-node-sources.js.map +0 -1
  194. package/dist/rules/implementations/no-unknown-fields.d.ts +0 -7
  195. package/dist/rules/implementations/no-unknown-fields.d.ts.map +0 -1
  196. package/dist/rules/implementations/no-unknown-fields.js +0 -216
  197. package/dist/rules/implementations/no-unknown-fields.js.map +0 -1
  198. package/dist/rules/implementations/orphaned-edge-types.d.ts +0 -7
  199. package/dist/rules/implementations/orphaned-edge-types.d.ts.map +0 -1
  200. package/dist/rules/implementations/orphaned-edge-types.js +0 -50
  201. package/dist/rules/implementations/orphaned-edge-types.js.map +0 -1
  202. package/dist/rules/implementations/orphaned-node-types.d.ts +0 -7
  203. package/dist/rules/implementations/orphaned-node-types.d.ts.map +0 -1
  204. package/dist/rules/implementations/orphaned-node-types.js +0 -53
  205. package/dist/rules/implementations/orphaned-node-types.js.map +0 -1
  206. package/dist/rules/implementations/required-metadata.d.ts +0 -7
  207. package/dist/rules/implementations/required-metadata.d.ts.map +0 -1
  208. package/dist/rules/implementations/required-metadata.js +0 -48
  209. package/dist/rules/implementations/required-metadata.js.map +0 -1
  210. package/dist/rules/implementations/state-transition-references.d.ts +0 -7
  211. package/dist/rules/implementations/state-transition-references.d.ts.map +0 -1
  212. package/dist/rules/implementations/state-transition-references.js +0 -138
  213. package/dist/rules/implementations/state-transition-references.js.map +0 -1
  214. package/dist/rules/implementations/unreachable-states.d.ts +0 -7
  215. package/dist/rules/implementations/unreachable-states.d.ts.map +0 -1
  216. package/dist/rules/implementations/unreachable-states.js +0 -83
  217. package/dist/rules/implementations/unreachable-states.js.map +0 -1
  218. package/dist/rules/implementations/valid-action-patterns.d.ts +0 -17
  219. package/dist/rules/implementations/valid-action-patterns.d.ts.map +0 -1
  220. package/dist/rules/implementations/valid-action-patterns.js +0 -112
  221. package/dist/rules/implementations/valid-action-patterns.js.map +0 -1
  222. package/dist/rules/implementations/valid-color-format.d.ts +0 -7
  223. package/dist/rules/implementations/valid-color-format.d.ts.map +0 -1
  224. package/dist/rules/implementations/valid-color-format.js +0 -94
  225. package/dist/rules/implementations/valid-color-format.js.map +0 -1
  226. package/dist/rules/implementations/valid-edge-types.d.ts +0 -7
  227. package/dist/rules/implementations/valid-edge-types.d.ts.map +0 -1
  228. package/dist/rules/implementations/valid-edge-types.js +0 -248
  229. package/dist/rules/implementations/valid-edge-types.js.map +0 -1
  230. package/dist/rules/implementations/valid-node-types.d.ts +0 -7
  231. package/dist/rules/implementations/valid-node-types.d.ts.map +0 -1
  232. package/dist/rules/implementations/valid-node-types.js +0 -187
  233. package/dist/rules/implementations/valid-node-types.js.map +0 -1
  234. package/dist/rules/index.d.ts +0 -28
  235. package/dist/rules/index.d.ts.map +0 -1
  236. package/dist/rules/index.js +0 -70
  237. package/dist/rules/index.js.map +0 -1
  238. package/dist/rules/types.d.ts +0 -309
  239. package/dist/rules/types.d.ts.map +0 -1
  240. package/dist/rules/types.js +0 -40
  241. package/dist/rules/types.js.map +0 -1
  242. package/dist/scopes/ScopePathIndex.d.ts +0 -56
  243. package/dist/scopes/ScopePathIndex.d.ts.map +0 -1
  244. package/dist/scopes/ScopePathIndex.js +0 -67
  245. package/dist/scopes/ScopePathIndex.js.map +0 -1
  246. package/dist/scopes/ScopesCanvasValidator.d.ts +0 -76
  247. package/dist/scopes/ScopesCanvasValidator.d.ts.map +0 -1
  248. package/dist/scopes/ScopesCanvasValidator.js +0 -221
  249. package/dist/scopes/ScopesCanvasValidator.js.map +0 -1
  250. package/dist/scopes/index.d.ts +0 -12
  251. package/dist/scopes/index.d.ts.map +0 -1
  252. package/dist/scopes/index.js +0 -30
  253. package/dist/scopes/index.js.map +0 -1
  254. package/dist/scopes/utils.d.ts +0 -85
  255. package/dist/scopes/utils.d.ts.map +0 -1
  256. package/dist/scopes/utils.js +0 -143
  257. package/dist/scopes/utils.js.map +0 -1
  258. package/dist/scopes/validateScopeNamespaceNesting.d.ts +0 -38
  259. package/dist/scopes/validateScopeNamespaceNesting.d.ts.map +0 -1
  260. package/dist/scopes/validateScopeNamespaceNesting.js +0 -69
  261. package/dist/scopes/validateScopeNamespaceNesting.js.map +0 -1
  262. package/dist/spans/index.d.ts +0 -12
  263. package/dist/spans/index.d.ts.map +0 -1
  264. package/dist/spans/index.js +0 -25
  265. package/dist/spans/index.js.map +0 -1
  266. package/dist/spans/utils.d.ts +0 -70
  267. package/dist/spans/utils.d.ts.map +0 -1
  268. package/dist/spans/utils.js +0 -205
  269. package/dist/spans/utils.js.map +0 -1
  270. package/dist/storyboard/builder.d.ts +0 -135
  271. package/dist/storyboard/builder.d.ts.map +0 -1
  272. package/dist/storyboard/builder.js +0 -235
  273. package/dist/storyboard/builder.js.map +0 -1
  274. package/dist/storyboard/index.d.ts +0 -9
  275. package/dist/storyboard/index.d.ts.map +0 -1
  276. package/dist/storyboard/index.js +0 -18
  277. package/dist/storyboard/index.js.map +0 -1
  278. package/dist/storyboard/types.d.ts +0 -101
  279. package/dist/storyboard/types.d.ts.map +0 -1
  280. package/dist/storyboard/types.js +0 -10
  281. package/dist/storyboard/types.js.map +0 -1
  282. package/dist/telemetry/coverage.d.ts +0 -92
  283. package/dist/telemetry/coverage.d.ts.map +0 -1
  284. package/dist/telemetry/coverage.js +0 -335
  285. package/dist/telemetry/coverage.js.map +0 -1
  286. package/dist/telemetry/event-validator.d.ts +0 -86
  287. package/dist/telemetry/event-validator.d.ts.map +0 -1
  288. package/dist/telemetry/event-validator.js +0 -257
  289. package/dist/telemetry/event-validator.js.map +0 -1
  290. package/dist/types/audit.d.ts +0 -236
  291. package/dist/types/audit.d.ts.map +0 -1
  292. package/dist/types/audit.js +0 -53
  293. package/dist/types/audit.js.map +0 -1
  294. package/dist/types/auxiliary.d.ts +0 -54
  295. package/dist/types/auxiliary.d.ts.map +0 -1
  296. package/dist/types/auxiliary.js +0 -27
  297. package/dist/types/auxiliary.js.map +0 -1
  298. package/dist/types/canvas-scope.d.ts +0 -156
  299. package/dist/types/canvas-scope.d.ts.map +0 -1
  300. package/dist/types/canvas-scope.js +0 -62
  301. package/dist/types/canvas-scope.js.map +0 -1
  302. package/dist/types/canvas.d.ts +0 -1138
  303. package/dist/types/canvas.d.ts.map +0 -1
  304. package/dist/types/canvas.js +0 -178
  305. package/dist/types/canvas.js.map +0 -1
  306. package/dist/types/dashboard.d.ts +0 -170
  307. package/dist/types/dashboard.d.ts.map +0 -1
  308. package/dist/types/dashboard.js +0 -14
  309. package/dist/types/dashboard.js.map +0 -1
  310. package/dist/types/library.d.ts +0 -227
  311. package/dist/types/library.d.ts.map +0 -1
  312. package/dist/types/library.js +0 -16
  313. package/dist/types/library.js.map +0 -1
  314. package/dist/types/otel.d.ts +0 -465
  315. package/dist/types/otel.d.ts.map +0 -1
  316. package/dist/types/otel.js +0 -163
  317. package/dist/types/otel.js.map +0 -1
  318. package/dist/types/path-based-config.d.ts +0 -235
  319. package/dist/types/path-based-config.d.ts.map +0 -1
  320. package/dist/types/path-based-config.js +0 -11
  321. package/dist/types/path-based-config.js.map +0 -1
  322. package/dist/types/registered-trace.d.ts +0 -337
  323. package/dist/types/registered-trace.d.ts.map +0 -1
  324. package/dist/types/registered-trace.js +0 -16
  325. package/dist/types/registered-trace.js.map +0 -1
  326. package/dist/types/resource-match.d.ts +0 -207
  327. package/dist/types/resource-match.d.ts.map +0 -1
  328. package/dist/types/resource-match.js +0 -74
  329. package/dist/types/resource-match.js.map +0 -1
  330. package/dist/types/version-registry.d.ts +0 -137
  331. package/dist/types/version-registry.d.ts.map +0 -1
  332. package/dist/types/version-registry.js +0 -10
  333. package/dist/types/version-registry.js.map +0 -1
  334. package/dist/utils/CanvasConverter.d.ts +0 -148
  335. package/dist/utils/CanvasConverter.d.ts.map +0 -1
  336. package/dist/utils/CanvasConverter.js +0 -530
  337. package/dist/utils/CanvasConverter.js.map +0 -1
  338. package/dist/utils/GraphConverter.d.ts +0 -18
  339. package/dist/utils/GraphConverter.d.ts.map +0 -1
  340. package/dist/utils/GraphConverter.js +0 -80
  341. package/dist/utils/GraphConverter.js.map +0 -1
  342. package/dist/utils/PathMatcher.d.ts +0 -55
  343. package/dist/utils/PathMatcher.d.ts.map +0 -1
  344. package/dist/utils/PathMatcher.js +0 -178
  345. package/dist/utils/PathMatcher.js.map +0 -1
  346. package/dist/utils/TraceToCanvas.d.ts +0 -83
  347. package/dist/utils/TraceToCanvas.d.ts.map +0 -1
  348. package/dist/utils/TraceToCanvas.js +0 -336
  349. package/dist/utils/TraceToCanvas.js.map +0 -1
  350. package/dist/utils/YamlParser.d.ts +0 -36
  351. package/dist/utils/YamlParser.d.ts.map +0 -1
  352. package/dist/utils/YamlParser.js +0 -92
  353. package/dist/utils/YamlParser.js.map +0 -1
  354. package/dist/utils/registeredTraceHelpers.d.ts +0 -76
  355. package/dist/utils/registeredTraceHelpers.d.ts.map +0 -1
  356. package/dist/utils/registeredTraceHelpers.js +0 -203
  357. package/dist/utils/registeredTraceHelpers.js.map +0 -1
  358. package/dist/utils/traceAggregation.d.ts +0 -25
  359. package/dist/utils/traceAggregation.d.ts.map +0 -1
  360. package/dist/utils/traceAggregation.js +0 -140
  361. package/dist/utils/traceAggregation.js.map +0 -1
  362. package/dist/validation/OtelCanvasValidator.d.ts +0 -40
  363. package/dist/validation/OtelCanvasValidator.d.ts.map +0 -1
  364. package/dist/validation/OtelCanvasValidator.js +0 -59
  365. package/dist/validation/OtelCanvasValidator.js.map +0 -1
  366. package/dist/validation/index.d.ts +0 -8
  367. package/dist/validation/index.d.ts.map +0 -1
  368. package/dist/validation/index.js +0 -13
  369. package/dist/validation/index.js.map +0 -1
  370. package/dist/validation/libraryValidation.d.ts +0 -53
  371. package/dist/validation/libraryValidation.d.ts.map +0 -1
  372. package/dist/validation/libraryValidation.js +0 -115
  373. package/dist/validation/libraryValidation.js.map +0 -1
  374. package/dist/workflow/edge-derivation.d.ts +0 -111
  375. package/dist/workflow/edge-derivation.d.ts.map +0 -1
  376. package/dist/workflow/edge-derivation.js +0 -174
  377. package/dist/workflow/edge-derivation.js.map +0 -1
  378. package/dist/workflow/edge-validation.d.ts +0 -170
  379. package/dist/workflow/edge-validation.d.ts.map +0 -1
  380. package/dist/workflow/edge-validation.js +0 -332
  381. package/dist/workflow/edge-validation.js.map +0 -1
  382. package/dist/workflow/example.d.ts +0 -11
  383. package/dist/workflow/example.d.ts.map +0 -1
  384. package/dist/workflow/example.js +0 -310
  385. package/dist/workflow/example.js.map +0 -1
  386. package/dist/workflow/index.d.ts +0 -20
  387. package/dist/workflow/index.d.ts.map +0 -1
  388. package/dist/workflow/index.js +0 -49
  389. package/dist/workflow/index.js.map +0 -1
  390. package/dist/workflow/scenario-matcher.d.ts +0 -63
  391. package/dist/workflow/scenario-matcher.d.ts.map +0 -1
  392. package/dist/workflow/scenario-matcher.js +0 -215
  393. package/dist/workflow/scenario-matcher.js.map +0 -1
  394. package/dist/workflow/template-parser.d.ts +0 -73
  395. package/dist/workflow/template-parser.d.ts.map +0 -1
  396. package/dist/workflow/template-parser.js +0 -280
  397. package/dist/workflow/template-parser.js.map +0 -1
  398. package/dist/workflow/template-renderer.d.ts +0 -45
  399. package/dist/workflow/template-renderer.d.ts.map +0 -1
  400. package/dist/workflow/template-renderer.js +0 -401
  401. package/dist/workflow/template-renderer.js.map +0 -1
  402. package/dist/workflow/types.d.ts +0 -393
  403. package/dist/workflow/types.d.ts.map +0 -1
  404. package/dist/workflow/types.js +0 -40
  405. package/dist/workflow/types.js.map +0 -1
  406. package/dist/workflow/validator.d.ts +0 -363
  407. package/dist/workflow/validator.d.ts.map +0 -1
  408. package/dist/workflow/validator.js +0 -2283
  409. package/dist/workflow/validator.js.map +0 -1
  410. package/schemas/auxiliary.manifest.schema.json +0 -56
  411. package/src/ConfigurationLoader.test.ts +0 -466
  412. package/src/ConfigurationLoader.ts +0 -184
  413. package/src/ConfigurationValidator.test.ts +0 -200
  414. package/src/ConfigurationValidator.ts +0 -273
  415. package/src/EventProcessor.test.ts +0 -405
  416. package/src/EventProcessor.ts +0 -256
  417. package/src/EventRecorderService.test.ts +0 -543
  418. package/src/EventRecorderService.ts +0 -741
  419. package/src/LibraryLoader.ts +0 -194
  420. package/src/PathBasedEventProcessor.test.ts +0 -336
  421. package/src/PathBasedEventProcessor.ts +0 -196
  422. package/src/SessionManager.test.ts +0 -424
  423. package/src/SessionManager.ts +0 -471
  424. package/src/ValidationEngine.test.ts +0 -520
  425. package/src/ValidationEngine.ts +0 -200
  426. package/src/auxiliary/AuxiliaryManifestValidator.test.ts +0 -93
  427. package/src/auxiliary/AuxiliaryManifestValidator.ts +0 -132
  428. package/src/auxiliary/index.ts +0 -18
  429. package/src/auxiliary/validateAreaScopeDisjoint.test.ts +0 -85
  430. package/src/auxiliary/validateAreaScopeDisjoint.ts +0 -72
  431. package/src/cli/codegen.ts +0 -286
  432. package/src/codegen/type-generator.test.ts +0 -219
  433. package/src/codegen/type-generator.ts +0 -560
  434. package/src/codegen/usage-example.ts +0 -357
  435. package/src/dashboard/DashboardValidator.ts +0 -904
  436. package/src/dashboard/index.ts +0 -14
  437. package/src/discovery/CanvasDiscovery.test.ts +0 -691
  438. package/src/discovery/CanvasDiscovery.ts +0 -1114
  439. package/src/discovery/CanvasFileManifest.test.ts +0 -521
  440. package/src/discovery/CanvasFileManifest.ts +0 -419
  441. package/src/discovery/LibraryDiscovery.test.ts +0 -329
  442. package/src/discovery/LibraryDiscovery.ts +0 -386
  443. package/src/discovery/types.ts +0 -453
  444. package/src/events/EventsCanvasValidator.test.ts +0 -191
  445. package/src/events/EventsCanvasValidator.ts +0 -428
  446. package/src/events/NamespacePathIndex.test.ts +0 -97
  447. package/src/events/NamespacePathIndex.ts +0 -100
  448. package/src/events/OtelEventPathsValidator.test.ts +0 -243
  449. package/src/events/OtelEventPathsValidator.ts +0 -191
  450. package/src/events/ScopeEventsValidator.test.ts +0 -173
  451. package/src/events/ScopeEventsValidator.ts +0 -158
  452. package/src/events/index.ts +0 -27
  453. package/src/events/path-helpers.ts +0 -53
  454. package/src/execution/ExecutionLoader.test.ts +0 -378
  455. package/src/execution/ExecutionLoader.ts +0 -331
  456. package/src/execution/ExecutionValidator.test.ts +0 -503
  457. package/src/execution/ExecutionValidator.ts +0 -617
  458. package/src/generated/graph-converter-execution.types.ts +0 -193
  459. package/src/helpers/GraphInstrumentationHelper.test.ts +0 -364
  460. package/src/helpers/GraphInstrumentationHelper.ts +0 -323
  461. package/src/matchers/SpanMatcher.test.ts +0 -1105
  462. package/src/matchers/SpanMatcher.ts +0 -381
  463. package/src/orchestration/TraceOrchestrator.ts +0 -560
  464. package/src/orchestration/__tests__/TraceOrchestrator.test.ts +0 -1098
  465. package/src/parsers/OtlpTraceParser.ts +0 -401
  466. package/src/parsers/__tests__/OtlpTraceParser.test.ts +0 -197
  467. package/src/registry/CompositeRegistry.ts +0 -140
  468. package/src/registry/EventRegistry.test.ts +0 -387
  469. package/src/registry/EventRegistry.ts +0 -191
  470. package/src/registry/LocalRegistry.ts +0 -416
  471. package/src/registry/RemoteRegistry.ts +0 -499
  472. package/src/registry/VersionRegistry.test.ts +0 -223
  473. package/src/registry/VersionRegistry.ts +0 -121
  474. package/src/rules/config.test.ts +0 -277
  475. package/src/rules/config.ts +0 -450
  476. package/src/rules/engine.test.ts +0 -331
  477. package/src/rules/engine.ts +0 -448
  478. package/src/rules/implementations/connection-type-references.ts +0 -117
  479. package/src/rules/implementations/dead-end-states.ts +0 -101
  480. package/src/rules/implementations/index.ts +0 -66
  481. package/src/rules/implementations/minimum-node-sources.ts +0 -84
  482. package/src/rules/implementations/no-unknown-fields.ts +0 -372
  483. package/src/rules/implementations/orphaned-edge-types.ts +0 -55
  484. package/src/rules/implementations/orphaned-node-types.ts +0 -58
  485. package/src/rules/implementations/required-metadata.ts +0 -52
  486. package/src/rules/implementations/state-transition-references.ts +0 -155
  487. package/src/rules/implementations/unreachable-states.ts +0 -94
  488. package/src/rules/implementations/valid-action-patterns.ts +0 -140
  489. package/src/rules/implementations/valid-color-format.ts +0 -152
  490. package/src/rules/implementations/valid-edge-types.ts +0 -273
  491. package/src/rules/implementations/valid-node-types.ts +0 -200
  492. package/src/rules/index.ts +0 -92
  493. package/src/rules/types.ts +0 -426
  494. package/src/scopes/ScopePathIndex.test.ts +0 -94
  495. package/src/scopes/ScopePathIndex.ts +0 -89
  496. package/src/scopes/ScopesCanvasValidator.test.ts +0 -127
  497. package/src/scopes/ScopesCanvasValidator.ts +0 -305
  498. package/src/scopes/__tests__/utils.test.ts +0 -383
  499. package/src/scopes/index.ts +0 -42
  500. package/src/scopes/utils.ts +0 -182
  501. package/src/scopes/validateScopeNamespaceNesting.test.ts +0 -127
  502. package/src/scopes/validateScopeNamespaceNesting.ts +0 -88
  503. package/src/spans/index.ts +0 -24
  504. package/src/spans/utils.ts +0 -249
  505. package/src/storyboard/builder.ts +0 -308
  506. package/src/storyboard/index.ts +0 -26
  507. package/src/storyboard/types.ts +0 -117
  508. package/src/telemetry/coverage.ts +0 -480
  509. package/src/telemetry/event-validator.ts +0 -312
  510. package/src/types/audit.ts +0 -314
  511. package/src/types/auxiliary.ts +0 -63
  512. package/src/types/canvas-scope.ts +0 -190
  513. package/src/types/canvas.test.ts +0 -199
  514. package/src/types/canvas.ts +0 -1395
  515. package/src/types/dashboard.ts +0 -257
  516. package/src/types/library.ts +0 -283
  517. package/src/types/otel.test.ts +0 -219
  518. package/src/types/otel.ts +0 -620
  519. package/src/types/path-based-config.ts +0 -285
  520. package/src/types/registered-trace.ts +0 -432
  521. package/src/types/resource-match.ts +0 -263
  522. package/src/types/version-registry.ts +0 -150
  523. package/src/utils/CanvasConverter.ts +0 -670
  524. package/src/utils/GraphConverter.test.ts +0 -322
  525. package/src/utils/GraphConverter.ts +0 -84
  526. package/src/utils/PathMatcher.test.ts +0 -139
  527. package/src/utils/PathMatcher.ts +0 -185
  528. package/src/utils/TraceToCanvas.test.ts +0 -310
  529. package/src/utils/TraceToCanvas.ts +0 -510
  530. package/src/utils/YamlParser.ts +0 -77
  531. package/src/utils/registeredTraceHelpers.ts +0 -251
  532. package/src/utils/traceAggregation.test.ts +0 -385
  533. package/src/utils/traceAggregation.ts +0 -173
  534. package/src/validation/OtelCanvasValidator.ts +0 -86
  535. package/src/validation/index.ts +0 -17
  536. package/src/validation/libraryValidation.ts +0 -206
  537. package/src/workflow/README.md +0 -408
  538. package/src/workflow/__tests__/edge-derivation.test.ts +0 -449
  539. package/src/workflow/__tests__/edge-validation.test.ts +0 -417
  540. package/src/workflow/__tests__/scenario-matcher.test.ts +0 -225
  541. package/src/workflow/__tests__/template-parser.test.ts +0 -276
  542. package/src/workflow/__tests__/template-renderer.test.ts +0 -509
  543. package/src/workflow/__tests__/types.test.ts +0 -187
  544. package/src/workflow/__tests__/validator.test.ts +0 -3225
  545. package/src/workflow/edge-derivation.ts +0 -265
  546. package/src/workflow/edge-validation.ts +0 -503
  547. package/src/workflow/example.ts +0 -330
  548. package/src/workflow/index.ts +0 -86
  549. package/src/workflow/scenario-matcher.ts +0 -253
  550. package/src/workflow/template-parser.ts +0 -350
  551. package/src/workflow/template-renderer.ts +0 -453
  552. package/src/workflow/types.ts +0 -511
  553. package/src/workflow/validator.ts +0 -2737
@@ -1,460 +1,7 @@
1
1
  /**
2
- * Core type definitions for the Principal View Framework
3
- * Based on GENERIC_GRAPH_PANEL_DESIGN.md
2
+ * Public type surface for @principal-ai/subsystems-core.
3
+ * Canvas / OTEL graph types were removed; this package is subsystem models +
4
+ * agent-session tooling (see /node and /pipeline entry points).
4
5
  */
5
6
 
6
- // ============================================================================
7
- // JSON-Serializable Types
8
- // ============================================================================
9
-
10
- /**
11
- * Represents any valid JSON value
12
- * Used for data that needs to be serialized/deserialized (events, telemetry, etc.)
13
- */
14
- export type JsonValue =
15
- | string
16
- | number
17
- | boolean
18
- | null
19
- | JsonValue[]
20
- | { [key: string]: JsonValue };
21
-
22
- /**
23
- * JSON object type - a record with JSON-serializable values
24
- */
25
- export type JsonObject = Record<string, JsonValue>;
26
-
27
- // ============================================================================
28
- // Domain-Specific Type Aliases
29
- // ============================================================================
30
-
31
- /**
32
- * Runtime data/properties for a graph node
33
- * Must conform to the schema defined in NodeTypeDefinition.dataSchema
34
- */
35
- export type NodeData = JsonObject;
36
-
37
- /**
38
- * Runtime data/properties for a graph edge
39
- * Must conform to the schema defined in EdgeTypeDefinition.dataSchema
40
- */
41
- export type EdgeData = JsonObject;
42
-
43
- /**
44
- * Additional metadata attached to events for observability/debugging
45
- * Examples: source location, stack trace, timing info, state transition details, etc.
46
- */
47
- export type EventMetadata = JsonObject;
48
-
49
- /**
50
- * Validation constraints for expected events
51
- * Key-value pairs that define expected properties and their values
52
- */
53
- export type ValidationConstraints = JsonObject;
54
-
55
- // ============================================================================
56
- // Graph Configuration Types
57
- // ============================================================================
58
-
59
- export interface GraphConfiguration {
60
- /** Metadata about the system being visualized */
61
- metadata: {
62
- name: string;
63
- description?: string;
64
- };
65
-
66
- /** Node type definitions */
67
- nodeTypes: Record<string, NodeTypeDefinition>;
68
-
69
- /** Edge type definitions */
70
- edgeTypes: Record<string, EdgeTypeDefinition>;
71
-
72
- /** Allowed connections between node types */
73
- allowedConnections: ConnectionRule[];
74
-
75
- /** Optional validation rules */
76
- validation?: ValidationRules;
77
-
78
- /** Display preferences */
79
- display?: DisplayConfiguration;
80
-
81
- /** Global state definitions (fallback for nodes without specific states) */
82
- states?: Record<
83
- string,
84
- {
85
- color?: string;
86
- icon?: string;
87
- label?: string;
88
- }
89
- >;
90
- }
91
-
92
- export interface NodeTypeDefinition {
93
- /** Description of this node type (required) */
94
- description: string;
95
- /** Visual representation */
96
- shape: 'circle' | 'rectangle' | 'hexagon' | 'diamond' | 'custom';
97
- icon?: string;
98
- /** Fill color (used as primary node color) */
99
- color?: string;
100
- /** Stroke/border color */
101
- stroke?: string;
102
- size?: { width: number; height: number };
103
-
104
- /** Data schema for this node type */
105
- dataSchema: {
106
- [field: string]: {
107
- type: 'string' | 'number' | 'boolean' | 'object' | 'array';
108
- required?: boolean;
109
- displayInLabel?: boolean;
110
- };
111
- };
112
-
113
- /** State definitions */
114
- states?: Record<
115
- string,
116
- {
117
- color?: string;
118
- icon?: string;
119
- label?: string;
120
- }
121
- >;
122
-
123
- /** Layout hints */
124
- layout?: {
125
- layer?: number;
126
- cluster?: string;
127
- };
128
- }
129
-
130
- export interface EdgeTypeDefinition {
131
- /** Visual style */
132
- style: 'solid' | 'dashed' | 'dotted' | 'animated';
133
- color?: string;
134
- width?: number;
135
- directed?: boolean;
136
- animated?: boolean;
137
-
138
- /** Edge label configuration */
139
- label?: {
140
- field?: string;
141
- position?: 'start' | 'middle' | 'end';
142
- };
143
-
144
- /** Animation configuration */
145
- animation?: {
146
- type: 'flow' | 'pulse' | 'particle' | 'glow';
147
- duration?: number;
148
- color?: string;
149
- };
150
-
151
- /** Data schema for edge metadata - fields to display when edge is clicked */
152
- dataSchema?: {
153
- [field: string]: {
154
- type: 'string' | 'number' | 'boolean' | 'object' | 'array';
155
- label?: string;
156
- displayInInfo?: boolean;
157
- };
158
- };
159
- }
160
-
161
- export interface ConnectionRule {
162
- from: string; // Node type
163
- to: string; // Node type
164
- via: string; // Edge type
165
-
166
- /** Optional constraints */
167
- constraints?: {
168
- maxInstances?: number;
169
- bidirectional?: boolean;
170
- exclusive?: boolean;
171
- };
172
- }
173
-
174
- export interface ValidationRules {
175
- /** State transition rules per node type */
176
- stateTransitions?: Record<
177
- string,
178
- Array<{
179
- from: string;
180
- to: string[];
181
- }>
182
- >;
183
-
184
- /** Global constraints */
185
- constraints?: Array<{
186
- id: string;
187
- description: string;
188
- check: string;
189
- severity: 'info' | 'warning' | 'error';
190
- }>;
191
-
192
- /** Cardinality rules */
193
- cardinality?: Record<
194
- string,
195
- {
196
- min?: number;
197
- max?: number;
198
- }
199
- >;
200
- }
201
-
202
- export interface DisplayConfiguration {
203
- /** Default layout algorithm */
204
- layout: 'hierarchical' | 'force-directed' | 'circular' | 'manual';
205
-
206
- /** Color scheme */
207
- theme?: {
208
- primary?: string;
209
- success?: string;
210
- warning?: string;
211
- danger?: string;
212
- info?: string;
213
- };
214
-
215
- /** Animation preferences */
216
- animations?: {
217
- enabled?: boolean;
218
- speed?: number;
219
- };
220
- }
221
-
222
- // ============================================================================
223
- // Event System Types
224
- // ============================================================================
225
-
226
- export interface GraphEvent {
227
- /** Unique event ID */
228
- id: string;
229
-
230
- /** Event type (user-defined) */
231
- type: string;
232
-
233
- /** When this event occurred */
234
- timestamp: number;
235
-
236
- /** Event category */
237
- category: 'node' | 'edge' | 'state' | 'data' | 'system';
238
-
239
- /** Event operation */
240
- operation: 'create' | 'update' | 'delete' | 'animate';
241
-
242
- /** Event payload */
243
- payload: NodeEvent | EdgeEvent | StateEvent | DataEvent | SystemEvent;
244
-
245
- /** Whether this event was expected */
246
- expected?: boolean;
247
-
248
- /** Optional metadata */
249
- metadata?: {
250
- source?: string;
251
- tags?: string[];
252
- description?: string;
253
- };
254
- }
255
-
256
- export interface NodeEvent {
257
- operation: 'create' | 'update' | 'delete';
258
- nodeId: string;
259
- nodeType: string;
260
- data?: NodeData;
261
- position?: { x: number; y: number };
262
- }
263
-
264
- export interface EdgeEvent {
265
- operation: 'create' | 'update' | 'delete' | 'animate';
266
- edgeId: string;
267
- edgeType: string;
268
- from: string;
269
- to: string;
270
- data?: EdgeData;
271
- animation?: {
272
- duration?: number;
273
- direction?: 'forward' | 'backward' | 'bidirectional';
274
- };
275
- }
276
-
277
- export interface StateEvent {
278
- nodeId: string;
279
- previousState?: string;
280
- newState: string;
281
- data?: EventMetadata;
282
- }
283
-
284
- export interface DataEvent {
285
- targetId: string;
286
- targetType: 'node' | 'edge';
287
- updates: JsonObject;
288
- }
289
-
290
- export interface SystemEvent {
291
- action: 'reset' | 'pause' | 'resume' | 'snapshot';
292
- data?: JsonValue;
293
- }
294
-
295
- // ============================================================================
296
- // Event Stream Protocol
297
- // ============================================================================
298
-
299
- export interface EventStream {
300
- /** Configuration (emitted once at start) */
301
- configuration: GraphConfiguration;
302
-
303
- /** Initial graph state (optional) */
304
- initialState?: {
305
- nodes: Array<Omit<NodeState, 'createdAt' | 'updatedAt'>>;
306
- edges: Array<Omit<EdgeState, 'createdAt' | 'updatedAt'>>;
307
- };
308
-
309
- /** Stream of events */
310
- events: GraphEvent[];
311
-
312
- /** Optional expected events for validation */
313
- expectedEvents?: Array<{
314
- type: string;
315
- constraints: ValidationConstraints;
316
- timing?: { minTime: number; maxTime: number };
317
- }>;
318
- }
319
-
320
- // ============================================================================
321
- // Validation Types
322
- // ============================================================================
323
-
324
- export interface ValidationResult {
325
- valid: boolean;
326
- violations: Violation[];
327
- warnings: Warning[];
328
- metrics: ValidationMetrics;
329
- }
330
-
331
- export interface Violation {
332
- id: string;
333
- severity: 'warning' | 'error';
334
- type: 'connection' | 'state' | 'cardinality' | 'constraint' | 'unexpected_event';
335
- description: string;
336
- event?: GraphEvent;
337
- context?: {
338
- nodeId?: string;
339
- edgeId?: string;
340
- rule?: string;
341
- };
342
- }
343
-
344
- export interface Warning {
345
- id: string;
346
- type: string;
347
- message: string;
348
- event?: GraphEvent;
349
- }
350
-
351
- export interface ValidationMetrics {
352
- totalEvents: number;
353
- validEvents: number;
354
- violations: number;
355
- warnings: number;
356
- unexpectedEvents: number;
357
- expectedEventsMissing: number;
358
- }
359
-
360
- // ============================================================================
361
- // Graph State Types
362
- // ============================================================================
363
-
364
- export interface GraphState {
365
- nodes: Map<string, NodeState>;
366
- edges: Map<string, EdgeState>;
367
- configuration: GraphConfiguration;
368
- }
369
-
370
- export interface NodeState {
371
- id: string;
372
- type: string;
373
- /** Display name for this node instance (required) */
374
- name: string;
375
- data: NodeData;
376
- state?: string;
377
- position?: { x: number; y: number };
378
- /** Node width (persisted from resize operations) */
379
- width?: number;
380
- /** Node height (persisted from resize operations) */
381
- height?: number;
382
- createdAt: number;
383
- updatedAt: number;
384
- }
385
-
386
- export interface EdgeState {
387
- id: string;
388
- type: string;
389
- from: string;
390
- to: string;
391
- data?: EdgeData;
392
- createdAt: number;
393
- updatedAt: number;
394
- }
395
-
396
- // ============================================================================
397
- // Metrics Types
398
- // ============================================================================
399
-
400
- export interface GraphMetrics {
401
- /** Node metrics */
402
- nodes: {
403
- total: number;
404
- byType: Record<string, number>;
405
- byState: Record<string, number>;
406
- };
407
-
408
- /** Edge metrics */
409
- edges: {
410
- total: number;
411
- byType: Record<string, number>;
412
- };
413
-
414
- /** Event metrics */
415
- events: {
416
- total: number;
417
- byCategory: Record<string, number>;
418
- byType: Record<string, number>;
419
- rate: number;
420
- };
421
-
422
- /** Validation metrics */
423
- validation: {
424
- violations: number;
425
- warnings: number;
426
- unexpectedEvents: number;
427
- healthScore: number;
428
- };
429
-
430
- /** Performance metrics */
431
- performance: {
432
- renderTime: number;
433
- eventProcessingTime: number;
434
- layoutTime: number;
435
- };
436
- }
437
-
438
- // ============================================================================
439
- // Path-Based Configuration Types (Milestone 1 & 2)
440
- // ============================================================================
441
-
442
- export * from './path-based-config';
443
-
444
- // ============================================================================
445
- // Component Library Types
446
- // ============================================================================
447
-
448
- export * from './library';
449
-
450
- // ============================================================================
451
- // OpenTelemetry and Resource Matching Types
452
- // ============================================================================
453
-
454
- export * from './otel';
455
- export * from './resource-match';
456
- export * from './canvas-scope';
457
- export * from './audit';
458
- export * from './dashboard';
459
- export * from './auxiliary';
460
7
  export * from './subsystem-model';
@@ -1,76 +0,0 @@
1
- /**
2
- * Configuration loader for managing multiple graph configurations
3
- *
4
- * Supports loading configurations from the .principal-views/ folder using the adapter pattern
5
- * for environment-agnostic file operations.
6
- */
7
- import type { FileSystemAdapter } from '@principal-ai/repository-abstraction';
8
- import type { PathBasedGraphConfiguration } from './types/path-based-config';
9
- /**
10
- * Represents a single configuration file
11
- */
12
- export interface ConfigurationFile {
13
- /** Configuration name (filename without extension) */
14
- name: string;
15
- /** Full path to the configuration file */
16
- path: string;
17
- /** Parsed configuration data */
18
- config: PathBasedGraphConfiguration;
19
- }
20
- /**
21
- * Result of loading all configurations
22
- */
23
- export interface ConfigurationLoadResult {
24
- /** Successfully loaded configurations */
25
- configs: ConfigurationFile[];
26
- /** Errors encountered during loading */
27
- errors: Array<{
28
- file: string;
29
- error: string;
30
- }>;
31
- }
32
- /**
33
- * Loader for managing multiple graph configurations from .principal-views/ folder
34
- */
35
- export declare class ConfigurationLoader {
36
- private fsAdapter;
37
- private static readonly CONFIG_DIR;
38
- constructor(fsAdapter: FileSystemAdapter);
39
- /**
40
- * Check if the .principal-views/ configuration directory exists
41
- *
42
- * @param baseDir - Base directory to search from
43
- * @returns True if .principal-views/ directory exists
44
- */
45
- hasConfigDirectory(baseDir: string): Promise<boolean>;
46
- /**
47
- * List all available configuration names in .principal-views/ folder
48
- *
49
- * @param baseDir - Base directory containing .principal-views/ folder
50
- * @returns Array of configuration names (without extensions)
51
- */
52
- listConfigurations(baseDir: string): Promise<string[]>;
53
- /**
54
- * Load a specific configuration by name
55
- *
56
- * @param name - Configuration name (without extension)
57
- * @param baseDir - Base directory containing .principal-views/ folder
58
- * @returns Configuration file or null if not found/invalid
59
- */
60
- loadByName(name: string, baseDir: string): Promise<ConfigurationFile | null>;
61
- /**
62
- * Load all configurations from .principal-views/ folder
63
- *
64
- * @param baseDir - Base directory containing .principal-views/ folder
65
- * @returns Result containing all loaded configs and any errors
66
- */
67
- loadAll(baseDir: string): Promise<ConfigurationLoadResult>;
68
- /**
69
- * Get the configuration directory path
70
- *
71
- * @param baseDir - Base directory
72
- * @returns Full path to .principal-views/ directory
73
- */
74
- getConfigDirectoryPath(baseDir: string): string;
75
- }
76
- //# sourceMappingURL=ConfigurationLoader.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ConfigurationLoader.d.ts","sourceRoot":"","sources":["../src/ConfigurationLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAG7E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,MAAM,EAAE,2BAA2B,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,wCAAwC;IACxC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAEpC,SAAS,EAAE,iBAAiB;IAEhD;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO3D;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW5D;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAkClF;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAwDhE;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGhD"}
@@ -1,148 +0,0 @@
1
- "use strict";
2
- /**
3
- * Configuration loader for managing multiple graph configurations
4
- *
5
- * Supports loading configurations from the .principal-views/ folder using the adapter pattern
6
- * for environment-agnostic file operations.
7
- */
8
- Object.defineProperty(exports, "__esModule", { value: true });
9
- exports.ConfigurationLoader = void 0;
10
- const YamlParser_1 = require("./utils/YamlParser");
11
- /**
12
- * Loader for managing multiple graph configurations from .principal-views/ folder
13
- */
14
- class ConfigurationLoader {
15
- constructor(fsAdapter) {
16
- this.fsAdapter = fsAdapter;
17
- }
18
- /**
19
- * Check if the .principal-views/ configuration directory exists
20
- *
21
- * @param baseDir - Base directory to search from
22
- * @returns True if .principal-views/ directory exists
23
- */
24
- async hasConfigDirectory(baseDir) {
25
- const configPath = this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
26
- const exists = await this.fsAdapter.exists(configPath);
27
- if (!exists)
28
- return false;
29
- return await this.fsAdapter.isDirectory(configPath);
30
- }
31
- /**
32
- * List all available configuration names in .principal-views/ folder
33
- *
34
- * @param baseDir - Base directory containing .principal-views/ folder
35
- * @returns Array of configuration names (without extensions)
36
- */
37
- async listConfigurations(baseDir) {
38
- if (!(await this.hasConfigDirectory(baseDir))) {
39
- return [];
40
- }
41
- const configPath = this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
42
- const files = await this.fsAdapter.readDir(configPath);
43
- return files.filter(YamlParser_1.isYamlFile).map(YamlParser_1.getConfigNameFromFilename).sort();
44
- }
45
- /**
46
- * Load a specific configuration by name
47
- *
48
- * @param name - Configuration name (without extension)
49
- * @param baseDir - Base directory containing .principal-views/ folder
50
- * @returns Configuration file or null if not found/invalid
51
- */
52
- async loadByName(name, baseDir) {
53
- if (!(await this.hasConfigDirectory(baseDir))) {
54
- return null;
55
- }
56
- const configPath = this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
57
- // Try both .yaml and .yml extensions
58
- for (const ext of ['yaml', 'yml']) {
59
- const filename = `${name}.${ext}`;
60
- const fullPath = this.fsAdapter.join(configPath, filename);
61
- if (await this.fsAdapter.exists(fullPath)) {
62
- try {
63
- const content = await this.fsAdapter.readFile(fullPath);
64
- const parseResult = (0, YamlParser_1.parseYaml)(content, filename);
65
- if (parseResult.success && parseResult.data) {
66
- return {
67
- name,
68
- path: fullPath,
69
- config: parseResult.data,
70
- };
71
- }
72
- }
73
- catch (error) {
74
- // File exists but couldn't be read or parsed
75
- return null;
76
- }
77
- }
78
- }
79
- return null;
80
- }
81
- /**
82
- * Load all configurations from .principal-views/ folder
83
- *
84
- * @param baseDir - Base directory containing .principal-views/ folder
85
- * @returns Result containing all loaded configs and any errors
86
- */
87
- async loadAll(baseDir) {
88
- const result = {
89
- configs: [],
90
- errors: [],
91
- };
92
- if (!(await this.hasConfigDirectory(baseDir))) {
93
- result.errors.push({
94
- file: '.principal-views',
95
- error: 'Configuration directory .principal-views/ not found',
96
- });
97
- return result;
98
- }
99
- const configPath = this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
100
- const files = await this.fsAdapter.readDir(configPath);
101
- for (const filename of files) {
102
- if (!(0, YamlParser_1.isYamlFile)(filename)) {
103
- continue; // Skip non-YAML files
104
- }
105
- const fullPath = this.fsAdapter.join(configPath, filename);
106
- const name = (0, YamlParser_1.getConfigNameFromFilename)(filename);
107
- try {
108
- const content = await this.fsAdapter.readFile(fullPath);
109
- const parseResult = (0, YamlParser_1.parseYaml)(content, filename);
110
- if (parseResult.success && parseResult.data) {
111
- result.configs.push({
112
- name,
113
- path: fullPath,
114
- config: parseResult.data,
115
- });
116
- }
117
- else if (parseResult.error) {
118
- result.errors.push({
119
- file: filename,
120
- error: parseResult.error,
121
- });
122
- }
123
- }
124
- catch (error) {
125
- const errorMessage = error instanceof Error ? error.message : String(error);
126
- result.errors.push({
127
- file: filename,
128
- error: `Failed to read file: ${errorMessage}`,
129
- });
130
- }
131
- }
132
- // Sort configs by name for consistent ordering
133
- result.configs.sort((a, b) => a.name.localeCompare(b.name));
134
- return result;
135
- }
136
- /**
137
- * Get the configuration directory path
138
- *
139
- * @param baseDir - Base directory
140
- * @returns Full path to .principal-views/ directory
141
- */
142
- getConfigDirectoryPath(baseDir) {
143
- return this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
144
- }
145
- }
146
- ConfigurationLoader.CONFIG_DIR = '.principal-views';
147
- exports.ConfigurationLoader = ConfigurationLoader;
148
- //# sourceMappingURL=ConfigurationLoader.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ConfigurationLoader.js","sourceRoot":"","sources":["../src/ConfigurationLoader.ts"],"names":[],"mappings":"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"}