@principal-ai/subsystems-core 0.29.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 (614) hide show
  1. package/README.md +124 -0
  2. package/dist/ConfigurationLoader.d.ts +76 -0
  3. package/dist/ConfigurationLoader.d.ts.map +1 -0
  4. package/dist/ConfigurationLoader.js +148 -0
  5. package/dist/ConfigurationLoader.js.map +1 -0
  6. package/dist/ConfigurationValidator.d.ts +31 -0
  7. package/dist/ConfigurationValidator.d.ts.map +1 -0
  8. package/dist/ConfigurationValidator.js +239 -0
  9. package/dist/ConfigurationValidator.js.map +1 -0
  10. package/dist/EventProcessor.d.ts +49 -0
  11. package/dist/EventProcessor.d.ts.map +1 -0
  12. package/dist/EventProcessor.js +220 -0
  13. package/dist/EventProcessor.js.map +1 -0
  14. package/dist/EventRecorderService.d.ts +305 -0
  15. package/dist/EventRecorderService.d.ts.map +1 -0
  16. package/dist/EventRecorderService.js +467 -0
  17. package/dist/EventRecorderService.js.map +1 -0
  18. package/dist/LibraryLoader.d.ts +65 -0
  19. package/dist/LibraryLoader.d.ts.map +1 -0
  20. package/dist/LibraryLoader.js +197 -0
  21. package/dist/LibraryLoader.js.map +1 -0
  22. package/dist/PathBasedEventProcessor.d.ts +77 -0
  23. package/dist/PathBasedEventProcessor.d.ts.map +1 -0
  24. package/dist/PathBasedEventProcessor.js +136 -0
  25. package/dist/PathBasedEventProcessor.js.map +1 -0
  26. package/dist/SessionManager.d.ts +194 -0
  27. package/dist/SessionManager.d.ts.map +1 -0
  28. package/dist/SessionManager.js +302 -0
  29. package/dist/SessionManager.js.map +1 -0
  30. package/dist/ValidationEngine.d.ts +31 -0
  31. package/dist/ValidationEngine.d.ts.map +1 -0
  32. package/dist/ValidationEngine.js +162 -0
  33. package/dist/ValidationEngine.js.map +1 -0
  34. package/dist/agent-sessions/fixture.d.ts +80 -0
  35. package/dist/agent-sessions/fixture.d.ts.map +1 -0
  36. package/dist/agent-sessions/fixture.js +130 -0
  37. package/dist/agent-sessions/fixture.js.map +1 -0
  38. package/dist/agent-sessions/index.d.ts +3 -0
  39. package/dist/agent-sessions/index.d.ts.map +1 -0
  40. package/dist/agent-sessions/index.js +6 -0
  41. package/dist/agent-sessions/index.js.map +1 -0
  42. package/dist/auxiliary/AuxiliaryManifestValidator.d.ts +41 -0
  43. package/dist/auxiliary/AuxiliaryManifestValidator.d.ts.map +1 -0
  44. package/dist/auxiliary/AuxiliaryManifestValidator.js +100 -0
  45. package/dist/auxiliary/AuxiliaryManifestValidator.js.map +1 -0
  46. package/dist/auxiliary/index.d.ts +9 -0
  47. package/dist/auxiliary/index.d.ts.map +1 -0
  48. package/dist/auxiliary/index.js +14 -0
  49. package/dist/auxiliary/index.js.map +1 -0
  50. package/dist/auxiliary/validateAreaScopeDisjoint.d.ts +24 -0
  51. package/dist/auxiliary/validateAreaScopeDisjoint.d.ts.map +1 -0
  52. package/dist/auxiliary/validateAreaScopeDisjoint.js +61 -0
  53. package/dist/auxiliary/validateAreaScopeDisjoint.js.map +1 -0
  54. package/dist/cli/codegen.d.ts +41 -0
  55. package/dist/cli/codegen.d.ts.map +1 -0
  56. package/dist/cli/codegen.js +257 -0
  57. package/dist/cli/codegen.js.map +1 -0
  58. package/dist/codegen/type-generator.d.ts +123 -0
  59. package/dist/codegen/type-generator.d.ts.map +1 -0
  60. package/dist/codegen/type-generator.js +433 -0
  61. package/dist/codegen/type-generator.js.map +1 -0
  62. package/dist/codegen/usage-example.d.ts +103 -0
  63. package/dist/codegen/usage-example.d.ts.map +1 -0
  64. package/dist/codegen/usage-example.js +258 -0
  65. package/dist/codegen/usage-example.js.map +1 -0
  66. package/dist/dashboard/DashboardValidator.d.ts +85 -0
  67. package/dist/dashboard/DashboardValidator.d.ts.map +1 -0
  68. package/dist/dashboard/DashboardValidator.js +775 -0
  69. package/dist/dashboard/DashboardValidator.js.map +1 -0
  70. package/dist/dashboard/index.d.ts +6 -0
  71. package/dist/dashboard/index.d.ts.map +1 -0
  72. package/dist/dashboard/index.js +10 -0
  73. package/dist/dashboard/index.js.map +1 -0
  74. package/dist/discovery/CanvasDiscovery.d.ts +160 -0
  75. package/dist/discovery/CanvasDiscovery.d.ts.map +1 -0
  76. package/dist/discovery/CanvasDiscovery.js +865 -0
  77. package/dist/discovery/CanvasDiscovery.js.map +1 -0
  78. package/dist/discovery/CanvasFileManifest.d.ts +86 -0
  79. package/dist/discovery/CanvasFileManifest.d.ts.map +1 -0
  80. package/dist/discovery/CanvasFileManifest.js +338 -0
  81. package/dist/discovery/CanvasFileManifest.js.map +1 -0
  82. package/dist/discovery/LibraryDiscovery.d.ts +108 -0
  83. package/dist/discovery/LibraryDiscovery.d.ts.map +1 -0
  84. package/dist/discovery/LibraryDiscovery.js +263 -0
  85. package/dist/discovery/LibraryDiscovery.js.map +1 -0
  86. package/dist/discovery/types.d.ts +403 -0
  87. package/dist/discovery/types.d.ts.map +1 -0
  88. package/dist/discovery/types.js +6 -0
  89. package/dist/discovery/types.js.map +1 -0
  90. package/dist/events/EventsCanvasValidator.d.ts +139 -0
  91. package/dist/events/EventsCanvasValidator.d.ts.map +1 -0
  92. package/dist/events/EventsCanvasValidator.js +281 -0
  93. package/dist/events/EventsCanvasValidator.js.map +1 -0
  94. package/dist/events/NamespacePathIndex.d.ts +61 -0
  95. package/dist/events/NamespacePathIndex.d.ts.map +1 -0
  96. package/dist/events/NamespacePathIndex.js +74 -0
  97. package/dist/events/NamespacePathIndex.js.map +1 -0
  98. package/dist/events/OtelEventPathsValidator.d.ts +75 -0
  99. package/dist/events/OtelEventPathsValidator.d.ts.map +1 -0
  100. package/dist/events/OtelEventPathsValidator.js +126 -0
  101. package/dist/events/OtelEventPathsValidator.js.map +1 -0
  102. package/dist/events/ScopeEventsValidator.d.ts +68 -0
  103. package/dist/events/ScopeEventsValidator.d.ts.map +1 -0
  104. package/dist/events/ScopeEventsValidator.js +91 -0
  105. package/dist/events/ScopeEventsValidator.js.map +1 -0
  106. package/dist/events/index.d.ts +9 -0
  107. package/dist/events/index.d.ts.map +1 -0
  108. package/dist/events/index.js +12 -0
  109. package/dist/events/index.js.map +1 -0
  110. package/dist/events/path-helpers.d.ts +33 -0
  111. package/dist/events/path-helpers.d.ts.map +1 -0
  112. package/dist/events/path-helpers.js +59 -0
  113. package/dist/events/path-helpers.js.map +1 -0
  114. package/dist/execution/ExecutionLoader.d.ts +135 -0
  115. package/dist/execution/ExecutionLoader.d.ts.map +1 -0
  116. package/dist/execution/ExecutionLoader.js +266 -0
  117. package/dist/execution/ExecutionLoader.js.map +1 -0
  118. package/dist/execution/ExecutionValidator.d.ts +94 -0
  119. package/dist/execution/ExecutionValidator.d.ts.map +1 -0
  120. package/dist/execution/ExecutionValidator.js +503 -0
  121. package/dist/execution/ExecutionValidator.js.map +1 -0
  122. package/dist/generated/graph-converter-execution.types.d.ts +177 -0
  123. package/dist/generated/graph-converter-execution.types.d.ts.map +1 -0
  124. package/dist/generated/graph-converter-execution.types.js +12 -0
  125. package/dist/generated/graph-converter-execution.types.js.map +1 -0
  126. package/dist/helpers/GraphInstrumentationHelper.d.ts +93 -0
  127. package/dist/helpers/GraphInstrumentationHelper.d.ts.map +1 -0
  128. package/dist/helpers/GraphInstrumentationHelper.js +252 -0
  129. package/dist/helpers/GraphInstrumentationHelper.js.map +1 -0
  130. package/dist/index.d.ts +82 -0
  131. package/dist/index.d.ts.map +1 -0
  132. package/dist/index.js +214 -0
  133. package/dist/index.js.map +1 -0
  134. package/dist/matchers/SpanMatcher.d.ts +107 -0
  135. package/dist/matchers/SpanMatcher.d.ts.map +1 -0
  136. package/dist/matchers/SpanMatcher.js +274 -0
  137. package/dist/matchers/SpanMatcher.js.map +1 -0
  138. package/dist/node.d.ts +78 -0
  139. package/dist/node.d.ts.map +1 -0
  140. package/dist/node.js +177 -0
  141. package/dist/node.js.map +1 -0
  142. package/dist/opencode/OpenCodeEventStore.d.ts +25 -0
  143. package/dist/opencode/OpenCodeEventStore.d.ts.map +1 -0
  144. package/dist/opencode/OpenCodeEventStore.js +182 -0
  145. package/dist/opencode/OpenCodeEventStore.js.map +1 -0
  146. package/dist/opencode/agent-sessions.d.ts +46 -0
  147. package/dist/opencode/agent-sessions.d.ts.map +1 -0
  148. package/dist/opencode/agent-sessions.js +302 -0
  149. package/dist/opencode/agent-sessions.js.map +1 -0
  150. package/dist/opencode/index.d.ts +6 -0
  151. package/dist/opencode/index.d.ts.map +1 -0
  152. package/dist/opencode/index.js +15 -0
  153. package/dist/opencode/index.js.map +1 -0
  154. package/dist/opencode/node-path-adapter.d.ts +25 -0
  155. package/dist/opencode/node-path-adapter.d.ts.map +1 -0
  156. package/dist/opencode/node-path-adapter.js +188 -0
  157. package/dist/opencode/node-path-adapter.js.map +1 -0
  158. package/dist/opencode/pipeline.d.ts +42 -0
  159. package/dist/opencode/pipeline.d.ts.map +1 -0
  160. package/dist/opencode/pipeline.js +90 -0
  161. package/dist/opencode/pipeline.js.map +1 -0
  162. package/dist/opencode/types.d.ts +39 -0
  163. package/dist/opencode/types.d.ts.map +1 -0
  164. package/dist/opencode/types.js +3 -0
  165. package/dist/opencode/types.js.map +1 -0
  166. package/dist/orchestration/TraceOrchestrator.d.ts +71 -0
  167. package/dist/orchestration/TraceOrchestrator.d.ts.map +1 -0
  168. package/dist/orchestration/TraceOrchestrator.js +416 -0
  169. package/dist/orchestration/TraceOrchestrator.js.map +1 -0
  170. package/dist/parsers/OtlpTraceParser.d.ts +131 -0
  171. package/dist/parsers/OtlpTraceParser.d.ts.map +1 -0
  172. package/dist/parsers/OtlpTraceParser.js +310 -0
  173. package/dist/parsers/OtlpTraceParser.js.map +1 -0
  174. package/dist/registry/CompositeRegistry.d.ts +71 -0
  175. package/dist/registry/CompositeRegistry.d.ts.map +1 -0
  176. package/dist/registry/CompositeRegistry.js +113 -0
  177. package/dist/registry/CompositeRegistry.js.map +1 -0
  178. package/dist/registry/EventRegistry.d.ts +79 -0
  179. package/dist/registry/EventRegistry.d.ts.map +1 -0
  180. package/dist/registry/EventRegistry.js +165 -0
  181. package/dist/registry/EventRegistry.js.map +1 -0
  182. package/dist/registry/LocalRegistry.d.ts +111 -0
  183. package/dist/registry/LocalRegistry.d.ts.map +1 -0
  184. package/dist/registry/LocalRegistry.js +335 -0
  185. package/dist/registry/LocalRegistry.js.map +1 -0
  186. package/dist/registry/RemoteRegistry.d.ts +122 -0
  187. package/dist/registry/RemoteRegistry.d.ts.map +1 -0
  188. package/dist/registry/RemoteRegistry.js +399 -0
  189. package/dist/registry/RemoteRegistry.js.map +1 -0
  190. package/dist/registry/VersionRegistry.d.ts +51 -0
  191. package/dist/registry/VersionRegistry.d.ts.map +1 -0
  192. package/dist/registry/VersionRegistry.js +105 -0
  193. package/dist/registry/VersionRegistry.js.map +1 -0
  194. package/dist/rules/config.d.ts +57 -0
  195. package/dist/rules/config.d.ts.map +1 -0
  196. package/dist/rules/config.js +382 -0
  197. package/dist/rules/config.js.map +1 -0
  198. package/dist/rules/engine.d.ts +70 -0
  199. package/dist/rules/engine.d.ts.map +1 -0
  200. package/dist/rules/engine.js +373 -0
  201. package/dist/rules/engine.js.map +1 -0
  202. package/dist/rules/implementations/connection-type-references.d.ts +7 -0
  203. package/dist/rules/implementations/connection-type-references.d.ts.map +1 -0
  204. package/dist/rules/implementations/connection-type-references.js +107 -0
  205. package/dist/rules/implementations/connection-type-references.js.map +1 -0
  206. package/dist/rules/implementations/dead-end-states.d.ts +17 -0
  207. package/dist/rules/implementations/dead-end-states.d.ts.map +1 -0
  208. package/dist/rules/implementations/dead-end-states.js +75 -0
  209. package/dist/rules/implementations/dead-end-states.js.map +1 -0
  210. package/dist/rules/implementations/index.d.ts +23 -0
  211. package/dist/rules/implementations/index.d.ts.map +1 -0
  212. package/dist/rules/implementations/index.js +73 -0
  213. package/dist/rules/implementations/index.js.map +1 -0
  214. package/dist/rules/implementations/minimum-node-sources.d.ts +24 -0
  215. package/dist/rules/implementations/minimum-node-sources.d.ts.map +1 -0
  216. package/dist/rules/implementations/minimum-node-sources.js +59 -0
  217. package/dist/rules/implementations/minimum-node-sources.js.map +1 -0
  218. package/dist/rules/implementations/no-unknown-fields.d.ts +7 -0
  219. package/dist/rules/implementations/no-unknown-fields.d.ts.map +1 -0
  220. package/dist/rules/implementations/no-unknown-fields.js +216 -0
  221. package/dist/rules/implementations/no-unknown-fields.js.map +1 -0
  222. package/dist/rules/implementations/orphaned-edge-types.d.ts +7 -0
  223. package/dist/rules/implementations/orphaned-edge-types.d.ts.map +1 -0
  224. package/dist/rules/implementations/orphaned-edge-types.js +50 -0
  225. package/dist/rules/implementations/orphaned-edge-types.js.map +1 -0
  226. package/dist/rules/implementations/orphaned-node-types.d.ts +7 -0
  227. package/dist/rules/implementations/orphaned-node-types.d.ts.map +1 -0
  228. package/dist/rules/implementations/orphaned-node-types.js +53 -0
  229. package/dist/rules/implementations/orphaned-node-types.js.map +1 -0
  230. package/dist/rules/implementations/required-metadata.d.ts +7 -0
  231. package/dist/rules/implementations/required-metadata.d.ts.map +1 -0
  232. package/dist/rules/implementations/required-metadata.js +48 -0
  233. package/dist/rules/implementations/required-metadata.js.map +1 -0
  234. package/dist/rules/implementations/state-transition-references.d.ts +7 -0
  235. package/dist/rules/implementations/state-transition-references.d.ts.map +1 -0
  236. package/dist/rules/implementations/state-transition-references.js +138 -0
  237. package/dist/rules/implementations/state-transition-references.js.map +1 -0
  238. package/dist/rules/implementations/unreachable-states.d.ts +7 -0
  239. package/dist/rules/implementations/unreachable-states.d.ts.map +1 -0
  240. package/dist/rules/implementations/unreachable-states.js +83 -0
  241. package/dist/rules/implementations/unreachable-states.js.map +1 -0
  242. package/dist/rules/implementations/valid-action-patterns.d.ts +17 -0
  243. package/dist/rules/implementations/valid-action-patterns.d.ts.map +1 -0
  244. package/dist/rules/implementations/valid-action-patterns.js +112 -0
  245. package/dist/rules/implementations/valid-action-patterns.js.map +1 -0
  246. package/dist/rules/implementations/valid-color-format.d.ts +7 -0
  247. package/dist/rules/implementations/valid-color-format.d.ts.map +1 -0
  248. package/dist/rules/implementations/valid-color-format.js +94 -0
  249. package/dist/rules/implementations/valid-color-format.js.map +1 -0
  250. package/dist/rules/implementations/valid-edge-types.d.ts +7 -0
  251. package/dist/rules/implementations/valid-edge-types.d.ts.map +1 -0
  252. package/dist/rules/implementations/valid-edge-types.js +248 -0
  253. package/dist/rules/implementations/valid-edge-types.js.map +1 -0
  254. package/dist/rules/implementations/valid-node-types.d.ts +7 -0
  255. package/dist/rules/implementations/valid-node-types.d.ts.map +1 -0
  256. package/dist/rules/implementations/valid-node-types.js +187 -0
  257. package/dist/rules/implementations/valid-node-types.js.map +1 -0
  258. package/dist/rules/index.d.ts +28 -0
  259. package/dist/rules/index.d.ts.map +1 -0
  260. package/dist/rules/index.js +70 -0
  261. package/dist/rules/index.js.map +1 -0
  262. package/dist/rules/types.d.ts +309 -0
  263. package/dist/rules/types.d.ts.map +1 -0
  264. package/dist/rules/types.js +40 -0
  265. package/dist/rules/types.js.map +1 -0
  266. package/dist/scopes/ScopePathIndex.d.ts +56 -0
  267. package/dist/scopes/ScopePathIndex.d.ts.map +1 -0
  268. package/dist/scopes/ScopePathIndex.js +67 -0
  269. package/dist/scopes/ScopePathIndex.js.map +1 -0
  270. package/dist/scopes/ScopesCanvasValidator.d.ts +76 -0
  271. package/dist/scopes/ScopesCanvasValidator.d.ts.map +1 -0
  272. package/dist/scopes/ScopesCanvasValidator.js +221 -0
  273. package/dist/scopes/ScopesCanvasValidator.js.map +1 -0
  274. package/dist/scopes/index.d.ts +12 -0
  275. package/dist/scopes/index.d.ts.map +1 -0
  276. package/dist/scopes/index.js +30 -0
  277. package/dist/scopes/index.js.map +1 -0
  278. package/dist/scopes/utils.d.ts +85 -0
  279. package/dist/scopes/utils.d.ts.map +1 -0
  280. package/dist/scopes/utils.js +143 -0
  281. package/dist/scopes/utils.js.map +1 -0
  282. package/dist/scopes/validateScopeNamespaceNesting.d.ts +38 -0
  283. package/dist/scopes/validateScopeNamespaceNesting.d.ts.map +1 -0
  284. package/dist/scopes/validateScopeNamespaceNesting.js +69 -0
  285. package/dist/scopes/validateScopeNamespaceNesting.js.map +1 -0
  286. package/dist/spans/index.d.ts +12 -0
  287. package/dist/spans/index.d.ts.map +1 -0
  288. package/dist/spans/index.js +25 -0
  289. package/dist/spans/index.js.map +1 -0
  290. package/dist/spans/utils.d.ts +70 -0
  291. package/dist/spans/utils.d.ts.map +1 -0
  292. package/dist/spans/utils.js +205 -0
  293. package/dist/spans/utils.js.map +1 -0
  294. package/dist/storage/topic-types.d.ts +203 -0
  295. package/dist/storage/topic-types.d.ts.map +1 -0
  296. package/dist/storage/topic-types.js +60 -0
  297. package/dist/storage/topic-types.js.map +1 -0
  298. package/dist/storage/topicStore.d.ts +135 -0
  299. package/dist/storage/topicStore.d.ts.map +1 -0
  300. package/dist/storage/topicStore.js +389 -0
  301. package/dist/storage/topicStore.js.map +1 -0
  302. package/dist/storyboard/builder.d.ts +135 -0
  303. package/dist/storyboard/builder.d.ts.map +1 -0
  304. package/dist/storyboard/builder.js +235 -0
  305. package/dist/storyboard/builder.js.map +1 -0
  306. package/dist/storyboard/index.d.ts +9 -0
  307. package/dist/storyboard/index.d.ts.map +1 -0
  308. package/dist/storyboard/index.js +18 -0
  309. package/dist/storyboard/index.js.map +1 -0
  310. package/dist/storyboard/types.d.ts +101 -0
  311. package/dist/storyboard/types.d.ts.map +1 -0
  312. package/dist/storyboard/types.js +10 -0
  313. package/dist/storyboard/types.js.map +1 -0
  314. package/dist/telemetry/coverage.d.ts +92 -0
  315. package/dist/telemetry/coverage.d.ts.map +1 -0
  316. package/dist/telemetry/coverage.js +335 -0
  317. package/dist/telemetry/coverage.js.map +1 -0
  318. package/dist/telemetry/event-validator.d.ts +86 -0
  319. package/dist/telemetry/event-validator.d.ts.map +1 -0
  320. package/dist/telemetry/event-validator.js +257 -0
  321. package/dist/telemetry/event-validator.js.map +1 -0
  322. package/dist/types/audit.d.ts +236 -0
  323. package/dist/types/audit.d.ts.map +1 -0
  324. package/dist/types/audit.js +53 -0
  325. package/dist/types/audit.js.map +1 -0
  326. package/dist/types/auxiliary.d.ts +54 -0
  327. package/dist/types/auxiliary.d.ts.map +1 -0
  328. package/dist/types/auxiliary.js +27 -0
  329. package/dist/types/auxiliary.js.map +1 -0
  330. package/dist/types/canvas-scope.d.ts +156 -0
  331. package/dist/types/canvas-scope.d.ts.map +1 -0
  332. package/dist/types/canvas-scope.js +62 -0
  333. package/dist/types/canvas-scope.js.map +1 -0
  334. package/dist/types/canvas.d.ts +1138 -0
  335. package/dist/types/canvas.d.ts.map +1 -0
  336. package/dist/types/canvas.js +178 -0
  337. package/dist/types/canvas.js.map +1 -0
  338. package/dist/types/dashboard.d.ts +170 -0
  339. package/dist/types/dashboard.d.ts.map +1 -0
  340. package/dist/types/dashboard.js +14 -0
  341. package/dist/types/dashboard.js.map +1 -0
  342. package/dist/types/index.d.ts +352 -0
  343. package/dist/types/index.d.ts.map +1 -0
  344. package/dist/types/index.js +39 -0
  345. package/dist/types/index.js.map +1 -0
  346. package/dist/types/library.d.ts +227 -0
  347. package/dist/types/library.d.ts.map +1 -0
  348. package/dist/types/library.js +16 -0
  349. package/dist/types/library.js.map +1 -0
  350. package/dist/types/otel.d.ts +465 -0
  351. package/dist/types/otel.d.ts.map +1 -0
  352. package/dist/types/otel.js +163 -0
  353. package/dist/types/otel.js.map +1 -0
  354. package/dist/types/path-based-config.d.ts +235 -0
  355. package/dist/types/path-based-config.d.ts.map +1 -0
  356. package/dist/types/path-based-config.js +11 -0
  357. package/dist/types/path-based-config.js.map +1 -0
  358. package/dist/types/registered-trace.d.ts +337 -0
  359. package/dist/types/registered-trace.d.ts.map +1 -0
  360. package/dist/types/registered-trace.js +16 -0
  361. package/dist/types/registered-trace.js.map +1 -0
  362. package/dist/types/resource-match.d.ts +207 -0
  363. package/dist/types/resource-match.d.ts.map +1 -0
  364. package/dist/types/resource-match.js +74 -0
  365. package/dist/types/resource-match.js.map +1 -0
  366. package/dist/types/subsystem-model.d.ts +265 -0
  367. package/dist/types/subsystem-model.d.ts.map +1 -0
  368. package/dist/types/subsystem-model.js +35 -0
  369. package/dist/types/subsystem-model.js.map +1 -0
  370. package/dist/types/version-registry.d.ts +137 -0
  371. package/dist/types/version-registry.d.ts.map +1 -0
  372. package/dist/types/version-registry.js +10 -0
  373. package/dist/types/version-registry.js.map +1 -0
  374. package/dist/utils/CanvasConverter.d.ts +148 -0
  375. package/dist/utils/CanvasConverter.d.ts.map +1 -0
  376. package/dist/utils/CanvasConverter.js +530 -0
  377. package/dist/utils/CanvasConverter.js.map +1 -0
  378. package/dist/utils/GraphConverter.d.ts +18 -0
  379. package/dist/utils/GraphConverter.d.ts.map +1 -0
  380. package/dist/utils/GraphConverter.js +80 -0
  381. package/dist/utils/GraphConverter.js.map +1 -0
  382. package/dist/utils/PathMatcher.d.ts +55 -0
  383. package/dist/utils/PathMatcher.d.ts.map +1 -0
  384. package/dist/utils/PathMatcher.js +178 -0
  385. package/dist/utils/PathMatcher.js.map +1 -0
  386. package/dist/utils/TraceToCanvas.d.ts +83 -0
  387. package/dist/utils/TraceToCanvas.d.ts.map +1 -0
  388. package/dist/utils/TraceToCanvas.js +336 -0
  389. package/dist/utils/TraceToCanvas.js.map +1 -0
  390. package/dist/utils/YamlParser.d.ts +36 -0
  391. package/dist/utils/YamlParser.d.ts.map +1 -0
  392. package/dist/utils/YamlParser.js +92 -0
  393. package/dist/utils/YamlParser.js.map +1 -0
  394. package/dist/utils/registeredTraceHelpers.d.ts +76 -0
  395. package/dist/utils/registeredTraceHelpers.d.ts.map +1 -0
  396. package/dist/utils/registeredTraceHelpers.js +203 -0
  397. package/dist/utils/registeredTraceHelpers.js.map +1 -0
  398. package/dist/utils/traceAggregation.d.ts +25 -0
  399. package/dist/utils/traceAggregation.d.ts.map +1 -0
  400. package/dist/utils/traceAggregation.js +140 -0
  401. package/dist/utils/traceAggregation.js.map +1 -0
  402. package/dist/validation/OtelCanvasValidator.d.ts +40 -0
  403. package/dist/validation/OtelCanvasValidator.d.ts.map +1 -0
  404. package/dist/validation/OtelCanvasValidator.js +59 -0
  405. package/dist/validation/OtelCanvasValidator.js.map +1 -0
  406. package/dist/validation/index.d.ts +8 -0
  407. package/dist/validation/index.d.ts.map +1 -0
  408. package/dist/validation/index.js +13 -0
  409. package/dist/validation/index.js.map +1 -0
  410. package/dist/validation/libraryValidation.d.ts +53 -0
  411. package/dist/validation/libraryValidation.d.ts.map +1 -0
  412. package/dist/validation/libraryValidation.js +115 -0
  413. package/dist/validation/libraryValidation.js.map +1 -0
  414. package/dist/workflow/edge-derivation.d.ts +111 -0
  415. package/dist/workflow/edge-derivation.d.ts.map +1 -0
  416. package/dist/workflow/edge-derivation.js +174 -0
  417. package/dist/workflow/edge-derivation.js.map +1 -0
  418. package/dist/workflow/edge-validation.d.ts +170 -0
  419. package/dist/workflow/edge-validation.d.ts.map +1 -0
  420. package/dist/workflow/edge-validation.js +332 -0
  421. package/dist/workflow/edge-validation.js.map +1 -0
  422. package/dist/workflow/example.d.ts +11 -0
  423. package/dist/workflow/example.d.ts.map +1 -0
  424. package/dist/workflow/example.js +310 -0
  425. package/dist/workflow/example.js.map +1 -0
  426. package/dist/workflow/index.d.ts +20 -0
  427. package/dist/workflow/index.d.ts.map +1 -0
  428. package/dist/workflow/index.js +49 -0
  429. package/dist/workflow/index.js.map +1 -0
  430. package/dist/workflow/scenario-matcher.d.ts +63 -0
  431. package/dist/workflow/scenario-matcher.d.ts.map +1 -0
  432. package/dist/workflow/scenario-matcher.js +215 -0
  433. package/dist/workflow/scenario-matcher.js.map +1 -0
  434. package/dist/workflow/template-parser.d.ts +73 -0
  435. package/dist/workflow/template-parser.d.ts.map +1 -0
  436. package/dist/workflow/template-parser.js +280 -0
  437. package/dist/workflow/template-parser.js.map +1 -0
  438. package/dist/workflow/template-renderer.d.ts +45 -0
  439. package/dist/workflow/template-renderer.d.ts.map +1 -0
  440. package/dist/workflow/template-renderer.js +401 -0
  441. package/dist/workflow/template-renderer.js.map +1 -0
  442. package/dist/workflow/types.d.ts +393 -0
  443. package/dist/workflow/types.d.ts.map +1 -0
  444. package/dist/workflow/types.js +40 -0
  445. package/dist/workflow/types.js.map +1 -0
  446. package/dist/workflow/validator.d.ts +363 -0
  447. package/dist/workflow/validator.d.ts.map +1 -0
  448. package/dist/workflow/validator.js +2283 -0
  449. package/dist/workflow/validator.js.map +1 -0
  450. package/package.json +84 -0
  451. package/schemas/auxiliary.manifest.schema.json +56 -0
  452. package/schemas/subsystem-model.schema.json +767 -0
  453. package/src/ConfigurationLoader.test.ts +466 -0
  454. package/src/ConfigurationLoader.ts +184 -0
  455. package/src/ConfigurationValidator.test.ts +200 -0
  456. package/src/ConfigurationValidator.ts +273 -0
  457. package/src/EventProcessor.test.ts +405 -0
  458. package/src/EventProcessor.ts +256 -0
  459. package/src/EventRecorderService.test.ts +543 -0
  460. package/src/EventRecorderService.ts +741 -0
  461. package/src/LibraryLoader.ts +194 -0
  462. package/src/PathBasedEventProcessor.test.ts +336 -0
  463. package/src/PathBasedEventProcessor.ts +196 -0
  464. package/src/SessionManager.test.ts +424 -0
  465. package/src/SessionManager.ts +471 -0
  466. package/src/ValidationEngine.test.ts +520 -0
  467. package/src/ValidationEngine.ts +200 -0
  468. package/src/agent-sessions/fixture.ts +225 -0
  469. package/src/agent-sessions/index.ts +10 -0
  470. package/src/auxiliary/AuxiliaryManifestValidator.test.ts +93 -0
  471. package/src/auxiliary/AuxiliaryManifestValidator.ts +132 -0
  472. package/src/auxiliary/index.ts +18 -0
  473. package/src/auxiliary/validateAreaScopeDisjoint.test.ts +85 -0
  474. package/src/auxiliary/validateAreaScopeDisjoint.ts +72 -0
  475. package/src/browser-safety.test.ts +170 -0
  476. package/src/cli/codegen.ts +286 -0
  477. package/src/codegen/type-generator.test.ts +219 -0
  478. package/src/codegen/type-generator.ts +560 -0
  479. package/src/codegen/usage-example.ts +357 -0
  480. package/src/dashboard/DashboardValidator.ts +904 -0
  481. package/src/dashboard/index.ts +14 -0
  482. package/src/discovery/CanvasDiscovery.test.ts +691 -0
  483. package/src/discovery/CanvasDiscovery.ts +1114 -0
  484. package/src/discovery/CanvasFileManifest.test.ts +521 -0
  485. package/src/discovery/CanvasFileManifest.ts +419 -0
  486. package/src/discovery/LibraryDiscovery.test.ts +329 -0
  487. package/src/discovery/LibraryDiscovery.ts +386 -0
  488. package/src/discovery/types.ts +453 -0
  489. package/src/events/EventsCanvasValidator.test.ts +191 -0
  490. package/src/events/EventsCanvasValidator.ts +428 -0
  491. package/src/events/NamespacePathIndex.test.ts +97 -0
  492. package/src/events/NamespacePathIndex.ts +100 -0
  493. package/src/events/OtelEventPathsValidator.test.ts +243 -0
  494. package/src/events/OtelEventPathsValidator.ts +191 -0
  495. package/src/events/ScopeEventsValidator.test.ts +173 -0
  496. package/src/events/ScopeEventsValidator.ts +158 -0
  497. package/src/events/index.ts +27 -0
  498. package/src/events/path-helpers.ts +53 -0
  499. package/src/execution/ExecutionLoader.test.ts +378 -0
  500. package/src/execution/ExecutionLoader.ts +331 -0
  501. package/src/execution/ExecutionValidator.test.ts +503 -0
  502. package/src/execution/ExecutionValidator.ts +617 -0
  503. package/src/generated/graph-converter-execution.types.ts +193 -0
  504. package/src/helpers/GraphInstrumentationHelper.test.ts +364 -0
  505. package/src/helpers/GraphInstrumentationHelper.ts +323 -0
  506. package/src/index.ts +587 -0
  507. package/src/matchers/SpanMatcher.test.ts +1105 -0
  508. package/src/matchers/SpanMatcher.ts +381 -0
  509. package/src/node.ts +316 -0
  510. package/src/opencode/EVENT_MAPPING.md +82 -0
  511. package/src/opencode/OpenCodeEventStore.ts +214 -0
  512. package/src/opencode/__fixtures__/event-shapes.json +443 -0
  513. package/src/opencode/__fixtures__/session-events.json +13491 -0
  514. package/src/opencode/agent-sessions.ts +376 -0
  515. package/src/opencode/index.ts +23 -0
  516. package/src/opencode/node-path-adapter.ts +205 -0
  517. package/src/opencode/pipeline.ts +141 -0
  518. package/src/opencode/types.ts +43 -0
  519. package/src/orchestration/TraceOrchestrator.ts +560 -0
  520. package/src/orchestration/__tests__/TraceOrchestrator.test.ts +1098 -0
  521. package/src/parsers/OtlpTraceParser.ts +401 -0
  522. package/src/parsers/__tests__/OtlpTraceParser.test.ts +197 -0
  523. package/src/registry/CompositeRegistry.ts +140 -0
  524. package/src/registry/EventRegistry.test.ts +387 -0
  525. package/src/registry/EventRegistry.ts +191 -0
  526. package/src/registry/LocalRegistry.ts +416 -0
  527. package/src/registry/RemoteRegistry.ts +499 -0
  528. package/src/registry/VersionRegistry.test.ts +223 -0
  529. package/src/registry/VersionRegistry.ts +121 -0
  530. package/src/rules/config.test.ts +277 -0
  531. package/src/rules/config.ts +450 -0
  532. package/src/rules/engine.test.ts +331 -0
  533. package/src/rules/engine.ts +448 -0
  534. package/src/rules/implementations/connection-type-references.ts +117 -0
  535. package/src/rules/implementations/dead-end-states.ts +101 -0
  536. package/src/rules/implementations/index.ts +66 -0
  537. package/src/rules/implementations/minimum-node-sources.ts +84 -0
  538. package/src/rules/implementations/no-unknown-fields.ts +372 -0
  539. package/src/rules/implementations/orphaned-edge-types.ts +55 -0
  540. package/src/rules/implementations/orphaned-node-types.ts +58 -0
  541. package/src/rules/implementations/required-metadata.ts +52 -0
  542. package/src/rules/implementations/state-transition-references.ts +155 -0
  543. package/src/rules/implementations/unreachable-states.ts +94 -0
  544. package/src/rules/implementations/valid-action-patterns.ts +140 -0
  545. package/src/rules/implementations/valid-color-format.ts +152 -0
  546. package/src/rules/implementations/valid-edge-types.ts +273 -0
  547. package/src/rules/implementations/valid-node-types.ts +200 -0
  548. package/src/rules/index.ts +92 -0
  549. package/src/rules/types.ts +426 -0
  550. package/src/scopes/ScopePathIndex.test.ts +94 -0
  551. package/src/scopes/ScopePathIndex.ts +89 -0
  552. package/src/scopes/ScopesCanvasValidator.test.ts +127 -0
  553. package/src/scopes/ScopesCanvasValidator.ts +305 -0
  554. package/src/scopes/__tests__/utils.test.ts +383 -0
  555. package/src/scopes/index.ts +42 -0
  556. package/src/scopes/utils.ts +182 -0
  557. package/src/scopes/validateScopeNamespaceNesting.test.ts +127 -0
  558. package/src/scopes/validateScopeNamespaceNesting.ts +88 -0
  559. package/src/spans/index.ts +24 -0
  560. package/src/spans/utils.ts +249 -0
  561. package/src/storage/topic-types.ts +235 -0
  562. package/src/storage/topicStore.test.ts +193 -0
  563. package/src/storage/topicStore.ts +489 -0
  564. package/src/storyboard/builder.ts +308 -0
  565. package/src/storyboard/index.ts +26 -0
  566. package/src/storyboard/types.ts +117 -0
  567. package/src/telemetry/coverage.ts +480 -0
  568. package/src/telemetry/event-validator.ts +312 -0
  569. package/src/types/audit.ts +314 -0
  570. package/src/types/auxiliary.ts +63 -0
  571. package/src/types/canvas-scope.ts +190 -0
  572. package/src/types/canvas.test.ts +199 -0
  573. package/src/types/canvas.ts +1395 -0
  574. package/src/types/dashboard.ts +257 -0
  575. package/src/types/index.ts +460 -0
  576. package/src/types/library.ts +283 -0
  577. package/src/types/otel.test.ts +219 -0
  578. package/src/types/otel.ts +620 -0
  579. package/src/types/path-based-config.ts +285 -0
  580. package/src/types/registered-trace.ts +432 -0
  581. package/src/types/resource-match.ts +263 -0
  582. package/src/types/subsystem-model.ts +352 -0
  583. package/src/types/version-registry.ts +150 -0
  584. package/src/utils/CanvasConverter.ts +670 -0
  585. package/src/utils/GraphConverter.test.ts +322 -0
  586. package/src/utils/GraphConverter.ts +84 -0
  587. package/src/utils/PathMatcher.test.ts +139 -0
  588. package/src/utils/PathMatcher.ts +185 -0
  589. package/src/utils/TraceToCanvas.test.ts +310 -0
  590. package/src/utils/TraceToCanvas.ts +510 -0
  591. package/src/utils/YamlParser.ts +77 -0
  592. package/src/utils/registeredTraceHelpers.ts +251 -0
  593. package/src/utils/traceAggregation.test.ts +385 -0
  594. package/src/utils/traceAggregation.ts +173 -0
  595. package/src/validation/OtelCanvasValidator.ts +86 -0
  596. package/src/validation/index.ts +17 -0
  597. package/src/validation/libraryValidation.ts +206 -0
  598. package/src/workflow/README.md +408 -0
  599. package/src/workflow/__tests__/edge-derivation.test.ts +449 -0
  600. package/src/workflow/__tests__/edge-validation.test.ts +417 -0
  601. package/src/workflow/__tests__/scenario-matcher.test.ts +225 -0
  602. package/src/workflow/__tests__/template-parser.test.ts +276 -0
  603. package/src/workflow/__tests__/template-renderer.test.ts +509 -0
  604. package/src/workflow/__tests__/types.test.ts +187 -0
  605. package/src/workflow/__tests__/validator.test.ts +3225 -0
  606. package/src/workflow/edge-derivation.ts +265 -0
  607. package/src/workflow/edge-validation.ts +503 -0
  608. package/src/workflow/example.ts +330 -0
  609. package/src/workflow/index.ts +86 -0
  610. package/src/workflow/scenario-matcher.ts +253 -0
  611. package/src/workflow/template-parser.ts +350 -0
  612. package/src/workflow/template-renderer.ts +453 -0
  613. package/src/workflow/types.ts +511 -0
  614. package/src/workflow/validator.ts +2737 -0
@@ -0,0 +1,433 @@
1
+ "use strict";
2
+ /**
3
+ * Type Generator
4
+ *
5
+ * Generates TypeScript types from canvas event schemas.
6
+ * Similar to how GraphQL Code Generator works for GraphQL schemas,
7
+ * or how OpenAPI generators work for API specs.
8
+ *
9
+ * Precedents:
10
+ * - GraphQL Code Generator: graphql-code-generator.com
11
+ * - OpenAPI Generator: openapi-generator.tech
12
+ * - Protobuf: generates code from .proto files
13
+ * - Zod: runtime validation with TypeScript inference
14
+ */
15
+ Object.defineProperty(exports, "__esModule", { value: true });
16
+ exports.generatorRegistry = exports.generateTypes = exports.TypeScriptGenerator = void 0;
17
+ const canvas_1 = require("../types/canvas");
18
+ /**
19
+ * TypeScript Type Generator
20
+ *
21
+ * Generates TypeScript types from canvas event schemas.
22
+ * Similar to GraphQL Code Generator but for canvas schemas.
23
+ */
24
+ class TypeScriptGenerator {
25
+ constructor() {
26
+ this.language = 'typescript';
27
+ }
28
+ generate(canvas, options, library) {
29
+ const opts = {
30
+ readonly: options?.style?.readonly ?? false,
31
+ strictNullChecks: options?.style?.strictNullChecks ?? true,
32
+ includeDocComments: options?.style?.includeDocComments ?? true,
33
+ namespace: options?.namespace,
34
+ };
35
+ const lines = [];
36
+ // File header
37
+ lines.push('/**');
38
+ lines.push(` * Generated types from canvas: ${canvas.name || canvas.pv?.name || 'Untitled'}`);
39
+ lines.push(' *');
40
+ lines.push(' * DO NOT EDIT MANUALLY - This file is auto-generated');
41
+ lines.push(' * Generated by @principal-ai/subsystems-core');
42
+ lines.push(' *');
43
+ lines.push(` * Canvas: ${canvas.pv?.description || 'No description'}`);
44
+ lines.push(' */');
45
+ lines.push('');
46
+ // Namespace (if specified)
47
+ if (opts.namespace) {
48
+ lines.push(`export namespace ${opts.namespace} {`);
49
+ }
50
+ // Group nodes by base ID (strip numeric suffixes like -1, -2, etc.)
51
+ // This allows multiple nodes representing states of the same component
52
+ // to be grouped into a single namespace
53
+ if (canvas.nodes) {
54
+ const nodeGroups = new Map();
55
+ for (const node of canvas.nodes) {
56
+ let eventSchema;
57
+ // Check for OTEL event node (top-level event/eventRef fields)
58
+ if ((0, canvas_1.isOtelEventNode)(node)) {
59
+ if (node.event) {
60
+ eventSchema = node.event;
61
+ }
62
+ else if (node.eventRef) {
63
+ eventSchema = this.resolveLibraryEvent(node.eventRef, library);
64
+ if (!eventSchema) {
65
+ console.warn(`Node '${node.id}' references unknown library event '${node.eventRef}'`);
66
+ continue;
67
+ }
68
+ }
69
+ }
70
+ // Check for standard node with pv.event/pv.eventRef
71
+ else if ((0, canvas_1.isStandardCanvasNode)(node)) {
72
+ if (node.pv?.event) {
73
+ eventSchema = node.pv.event;
74
+ }
75
+ else if (node.pv?.eventRef) {
76
+ eventSchema = this.resolveLibraryEvent(node.pv.eventRef, library);
77
+ if (!eventSchema) {
78
+ console.warn(`Node '${node.id}' references unknown library event '${node.pv.eventRef}'`);
79
+ continue;
80
+ }
81
+ }
82
+ }
83
+ if (eventSchema) {
84
+ // Group by base ID (e.g., "graph-converter-1" -> "graph-converter")
85
+ const baseId = node.id.replace(/-\d+$/, '');
86
+ if (!nodeGroups.has(baseId)) {
87
+ nodeGroups.set(baseId, []);
88
+ }
89
+ nodeGroups.get(baseId).push({ nodeId: node.id, eventSchema });
90
+ }
91
+ }
92
+ // Generate types for each component group
93
+ for (const [baseId, nodes] of nodeGroups) {
94
+ lines.push(...this.generateComponentTypes(baseId, nodes, opts));
95
+ lines.push('');
96
+ }
97
+ }
98
+ // Generate union type of all event names
99
+ lines.push(...this.generateEventNameUnion(canvas, opts, library));
100
+ lines.push('');
101
+ // Generate event emitter helper type
102
+ lines.push(...this.generateEmitterTypes(canvas, opts));
103
+ // Close namespace
104
+ if (opts.namespace) {
105
+ lines.push('}');
106
+ }
107
+ const code = lines.join('\n');
108
+ const filename = this.generateFilename(canvas);
109
+ return {
110
+ code,
111
+ extension: 'ts',
112
+ filename,
113
+ };
114
+ }
115
+ /**
116
+ * Generate types for a component (group of related nodes)
117
+ * Groups multiple node instances (e.g., graph-converter-1, graph-converter-2)
118
+ * into a single namespace with all their events
119
+ */
120
+ generateComponentTypes(baseId, nodes, opts) {
121
+ const lines = [];
122
+ const typeName = this.nodeIdToTypeName(baseId);
123
+ if (opts.includeDocComments) {
124
+ lines.push(`/**`);
125
+ lines.push(` * Event types for component: ${baseId}`);
126
+ lines.push(` */`);
127
+ }
128
+ lines.push(`export namespace ${typeName} {`);
129
+ // Generate interface for each event in the component
130
+ const interfaceNames = [];
131
+ const eventNames = [];
132
+ for (const { eventSchema } of nodes) {
133
+ lines.push(...this.generateEventInterface(eventSchema.name, eventSchema, opts));
134
+ lines.push('');
135
+ interfaceNames.push(this.eventNameToTypeName(eventSchema.name));
136
+ eventNames.push(eventSchema.name);
137
+ }
138
+ // Export union of all event types
139
+ if (opts.includeDocComments) {
140
+ lines.push(' /**');
141
+ lines.push(` * All event types for ${baseId}`);
142
+ lines.push(' */');
143
+ }
144
+ if (interfaceNames.length === 1) {
145
+ lines.push(` export type Event = ${interfaceNames[0]};`);
146
+ }
147
+ else {
148
+ lines.push(` export type Event = ${interfaceNames.join(' | ')};`);
149
+ }
150
+ lines.push('');
151
+ // Generate event name union
152
+ if (opts.includeDocComments) {
153
+ lines.push(' /**');
154
+ lines.push(` * All event names for ${baseId}`);
155
+ lines.push(' */');
156
+ }
157
+ if (eventNames.length === 1) {
158
+ lines.push(` export type EventName = '${eventNames[0]}';`);
159
+ }
160
+ else {
161
+ lines.push(` export type EventName = ${eventNames.map(n => `'${n}'`).join(' | ')};`);
162
+ }
163
+ lines.push('}');
164
+ return lines;
165
+ }
166
+ generateNodeTypes(nodeId, eventSchema, opts) {
167
+ const lines = [];
168
+ const typeName = this.nodeIdToTypeName(nodeId);
169
+ if (opts.includeDocComments) {
170
+ lines.push(`/**`);
171
+ lines.push(` * Event type for node: ${nodeId}`);
172
+ lines.push(` */`);
173
+ }
174
+ lines.push(`export namespace ${typeName} {`);
175
+ // Generate interface for the single event
176
+ lines.push(...this.generateEventInterface(eventSchema.name, eventSchema, opts));
177
+ lines.push('');
178
+ // Export the event type directly (no union needed for single event)
179
+ const interfaceName = this.eventNameToTypeName(eventSchema.name);
180
+ lines.push(' /**');
181
+ lines.push(` * Event type for ${nodeId}`);
182
+ lines.push(' */');
183
+ lines.push(` export type Event = ${interfaceName};`);
184
+ lines.push('');
185
+ // Generate event name literal
186
+ lines.push(' /**');
187
+ lines.push(` * Event name for ${nodeId}`);
188
+ lines.push(' */');
189
+ lines.push(` export type EventName = '${eventSchema.name}';`);
190
+ lines.push('}');
191
+ return lines;
192
+ }
193
+ generateEventInterface(eventName, schema, opts) {
194
+ const lines = [];
195
+ const interfaceName = this.eventNameToTypeName(eventName);
196
+ const readonly = opts.readonly ? 'readonly ' : '';
197
+ if (opts.includeDocComments) {
198
+ lines.push(' /**');
199
+ lines.push(` * ${schema.description}`);
200
+ lines.push(' */');
201
+ }
202
+ lines.push(` export interface ${interfaceName} {`);
203
+ // Event name as literal type
204
+ lines.push(` ${readonly}name: '${eventName}';`);
205
+ // Attributes
206
+ lines.push(` ${readonly}attributes: {`);
207
+ for (const [fieldName, fieldSchema] of Object.entries(schema.attributes)) {
208
+ const optional = !fieldSchema.required && opts.strictNullChecks ? '?' : '';
209
+ const type = this.fieldTypeToTsType(fieldSchema);
210
+ if (opts.includeDocComments && fieldSchema.description) {
211
+ lines.push(` /** ${fieldSchema.description} */`);
212
+ }
213
+ lines.push(` ${readonly}'${fieldName}'${optional}: ${type};`);
214
+ }
215
+ lines.push(' };');
216
+ lines.push(' }');
217
+ return lines;
218
+ }
219
+ generateEventNameUnion(canvas, opts, library) {
220
+ const lines = [];
221
+ const allEventNames = new Set();
222
+ if (canvas.nodes) {
223
+ for (const node of canvas.nodes) {
224
+ // Check for OTEL event node (top-level event/eventRef fields)
225
+ if ((0, canvas_1.isOtelEventNode)(node)) {
226
+ if (node.event?.name) {
227
+ allEventNames.add(node.event.name);
228
+ }
229
+ else if (node.eventRef) {
230
+ const eventSchema = this.resolveLibraryEvent(node.eventRef, library);
231
+ if (eventSchema) {
232
+ allEventNames.add(eventSchema.name);
233
+ }
234
+ }
235
+ }
236
+ // Check for standard node with pv.event/pv.eventRef
237
+ else if ((0, canvas_1.isStandardCanvasNode)(node)) {
238
+ if (node.pv?.event?.name) {
239
+ allEventNames.add(node.pv.event.name);
240
+ }
241
+ else if (node.pv?.eventRef) {
242
+ const eventSchema = this.resolveLibraryEvent(node.pv.eventRef, library);
243
+ if (eventSchema) {
244
+ allEventNames.add(eventSchema.name);
245
+ }
246
+ }
247
+ }
248
+ }
249
+ }
250
+ if (allEventNames.size === 0) {
251
+ return lines;
252
+ }
253
+ if (opts.includeDocComments) {
254
+ lines.push('/**');
255
+ lines.push(' * Union of all event names in the canvas');
256
+ lines.push(' */');
257
+ }
258
+ lines.push(`export type AllEventNames = ${Array.from(allEventNames).map(n => `'${n}'`).join(' | ')};`);
259
+ return lines;
260
+ }
261
+ generateEmitterTypes(canvas, opts) {
262
+ const lines = [];
263
+ if (opts.includeDocComments) {
264
+ lines.push('/**');
265
+ lines.push(' * Type-safe event emitter for a specific node');
266
+ lines.push(' *');
267
+ lines.push(' * @example');
268
+ lines.push(' * ```typescript');
269
+ lines.push(' * const emit: NodeEmitter<GraphConverter.EventName, GraphConverter.Event> = ...');
270
+ lines.push(" * emit('conversion.started', {");
271
+ lines.push(" * name: 'conversion.started',");
272
+ lines.push(' * attributes: { ... }');
273
+ lines.push(' * });');
274
+ lines.push(' * ```');
275
+ lines.push(' */');
276
+ }
277
+ lines.push('export type NodeEmitter<');
278
+ lines.push(' TEventName extends string,');
279
+ lines.push(' TEvent extends { name: TEventName; attributes: Record<string, any> }');
280
+ lines.push('> = (event: TEvent) => void;');
281
+ lines.push('');
282
+ if (opts.includeDocComments) {
283
+ lines.push('/**');
284
+ lines.push(' * Type-safe event emitter by event name');
285
+ lines.push(' *');
286
+ lines.push(' * @example');
287
+ lines.push(' * ```typescript');
288
+ lines.push(' * const emit: NodeEmitterByName<GraphConverter.Event> = ...');
289
+ lines.push(" * emit('conversion.started', {");
290
+ lines.push(" * 'config.nodeTypes': 2,");
291
+ lines.push(" * 'config.edgeTypes': 1");
292
+ lines.push(' * });');
293
+ lines.push(' * ```');
294
+ lines.push(' */');
295
+ }
296
+ lines.push('export type NodeEmitterByName<');
297
+ lines.push(' TEvent extends { name: string; attributes: Record<string, any> }');
298
+ lines.push('> = <TName extends TEvent[\'name\']>(');
299
+ lines.push(' eventName: TName,');
300
+ lines.push(' attributes: Extract<TEvent, { name: TName }>[\'attributes\']');
301
+ lines.push(') => void;');
302
+ return lines;
303
+ }
304
+ nodeIdToTypeName(nodeId) {
305
+ // Convert kebab-case or snake_case to PascalCase
306
+ return nodeId
307
+ .split(/[-_]/)
308
+ .map(part => part.charAt(0).toUpperCase() + part.slice(1))
309
+ .join('');
310
+ }
311
+ eventNameToTypeName(eventName) {
312
+ // Convert "conversion.started" to "ConversionStarted"
313
+ return eventName
314
+ .split('.')
315
+ .map(part => part.charAt(0).toUpperCase() + part.slice(1))
316
+ .join('');
317
+ }
318
+ fieldTypeToTsType(fieldSchema) {
319
+ switch (fieldSchema.type) {
320
+ case 'string':
321
+ return 'string';
322
+ case 'number':
323
+ return 'number';
324
+ case 'boolean':
325
+ return 'boolean';
326
+ case 'array':
327
+ return 'any[]';
328
+ case 'object':
329
+ return 'Record<string, any>';
330
+ default:
331
+ return 'any';
332
+ }
333
+ }
334
+ generateFilename(canvas) {
335
+ const name = canvas.pv?.name || 'canvas';
336
+ // Convert to kebab-case
337
+ const kebab = name
338
+ .toLowerCase()
339
+ .replace(/\s+/g, '-')
340
+ .replace(/[^a-z0-9-]/g, '');
341
+ return `${kebab}.types.ts`;
342
+ }
343
+ /**
344
+ * Resolve an event schema from library by event name
345
+ */
346
+ resolveLibraryEvent(eventName, library) {
347
+ if (!library?.eventSchemas) {
348
+ return undefined;
349
+ }
350
+ const librarySchema = library.eventSchemas[eventName];
351
+ if (!librarySchema) {
352
+ return undefined;
353
+ }
354
+ // Convert library schema (without name) to full PVEventSchema
355
+ return {
356
+ name: eventName,
357
+ description: librarySchema.description,
358
+ attributes: librarySchema.attributes,
359
+ };
360
+ }
361
+ }
362
+ exports.TypeScriptGenerator = TypeScriptGenerator;
363
+ /**
364
+ * Generate types from canvas
365
+ *
366
+ * @example
367
+ * ```typescript
368
+ * import fs from 'fs';
369
+ * import { generateTypes } from '@principal-ai/subsystems-core';
370
+ *
371
+ * const canvas = JSON.parse(fs.readFileSync('my-flow.canvas', 'utf-8'));
372
+ * const result = generateTypes(canvas, { language: 'typescript' });
373
+ *
374
+ * fs.writeFileSync(result.filename, result.code);
375
+ * ```
376
+ */
377
+ function generateTypes(canvas, options = { language: 'typescript' }, library) {
378
+ const generator = getGenerator(options.language);
379
+ return generator.generate(canvas, options, library);
380
+ }
381
+ exports.generateTypes = generateTypes;
382
+ /**
383
+ * Get code generator for a language
384
+ */
385
+ function getGenerator(language) {
386
+ switch (language) {
387
+ case 'typescript':
388
+ return new TypeScriptGenerator();
389
+ case 'python':
390
+ // TODO: Implement Python generator
391
+ throw new Error('Python generator not yet implemented. See TypeScriptGenerator as reference.');
392
+ case 'go':
393
+ // TODO: Implement Go generator
394
+ throw new Error('Go generator not yet implemented. See TypeScriptGenerator as reference.');
395
+ case 'rust':
396
+ // TODO: Implement Rust generator
397
+ throw new Error('Rust generator not yet implemented. See TypeScriptGenerator as reference.');
398
+ default:
399
+ throw new Error(`Unsupported language: ${language}`);
400
+ }
401
+ }
402
+ /**
403
+ * Registry of available generators
404
+ *
405
+ * This allows external packages to register custom generators:
406
+ *
407
+ * @example
408
+ * ```typescript
409
+ * import { generatorRegistry } from '@principal-ai/subsystems-core';
410
+ *
411
+ * class PythonGenerator implements CodeGenerator {
412
+ * language = 'python';
413
+ * generate(canvas, options) { ... }
414
+ * }
415
+ *
416
+ * generatorRegistry.register(new PythonGenerator());
417
+ * ```
418
+ */
419
+ exports.generatorRegistry = {
420
+ generators: new Map([
421
+ ['typescript', new TypeScriptGenerator()],
422
+ ]),
423
+ register(generator) {
424
+ this.generators.set(generator.language, generator);
425
+ },
426
+ get(language) {
427
+ return this.generators.get(language);
428
+ },
429
+ list() {
430
+ return Array.from(this.generators.keys());
431
+ },
432
+ };
433
+ //# sourceMappingURL=type-generator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"type-generator.js","sourceRoot":"","sources":["../../src/codegen/type-generator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,103 @@
1
+ /**
2
+ * Example: Using Generated Types
3
+ *
4
+ * This demonstrates how to use generated types for type-safe event emission.
5
+ * Types are generated from canvas schemas using the type generator.
6
+ *
7
+ * Similar to:
8
+ * - GraphQL Code Generator usage
9
+ * - OpenAPI generated client usage
10
+ * - Protobuf generated message usage
11
+ *
12
+ * NOTE: In real code, you would import from the generated types file:
13
+ * ```typescript
14
+ * import type {
15
+ * GraphConverter,
16
+ * Validation,
17
+ * NodeEmitterByName,
18
+ * } from '@generated/graph-converter-execution.types';
19
+ * ```
20
+ *
21
+ * For this example file, we define the types inline to avoid import errors.
22
+ */
23
+ declare namespace GraphConverter {
24
+ interface ConversionStarted {
25
+ name: 'conversion.started';
26
+ attributes: {
27
+ 'config.nodeTypes': number;
28
+ 'config.edgeTypes': number;
29
+ };
30
+ }
31
+ interface ConversionComplete {
32
+ name: 'conversion.complete';
33
+ attributes: {
34
+ 'result.nodes.count': number;
35
+ 'result.edges.count': number;
36
+ 'duration.ms'?: number;
37
+ };
38
+ }
39
+ interface ConversionError {
40
+ name: 'conversion.error';
41
+ attributes: {
42
+ 'error.message': string;
43
+ 'error.phase'?: string;
44
+ };
45
+ }
46
+ interface ConversionProcessingNodes {
47
+ name: 'conversion.processingNodes';
48
+ attributes: {
49
+ 'nodes.count': number;
50
+ };
51
+ }
52
+ interface ConversionProcessingEdges {
53
+ name: 'conversion.processingEdges';
54
+ attributes: {
55
+ 'edges.count': number;
56
+ };
57
+ }
58
+ type Event = ConversionStarted | ConversionComplete | ConversionError | ConversionProcessingNodes | ConversionProcessingEdges;
59
+ type EventName = 'conversion.started' | 'conversion.processingNodes' | 'conversion.processingEdges' | 'conversion.complete' | 'conversion.error';
60
+ }
61
+ type NodeEmitterByName<TEvent extends {
62
+ name: string;
63
+ attributes: Record<string, any>;
64
+ }> = <TName extends TEvent['name']>(eventName: TName, attributes: Extract<TEvent, {
65
+ name: TName;
66
+ }>['attributes']) => void;
67
+ /**
68
+ * Example 1: Type-safe event emitter with full event objects
69
+ */
70
+ declare function exampleFullEventEmitter(): void;
71
+ /**
72
+ * Example 2: Type-safe event emitter by name (more ergonomic)
73
+ */
74
+ declare function exampleEventEmitterByName(): void;
75
+ /**
76
+ * Example 3: Production service with type-safe telemetry
77
+ */
78
+ declare class GraphConverterService {
79
+ private emit;
80
+ constructor(emitter: NodeEmitterByName<GraphConverter.Event>);
81
+ convert(config: {
82
+ nodeTypes: string[];
83
+ edgeTypes: string[];
84
+ }): void;
85
+ }
86
+ /**
87
+ * Example 4: Multiple node types
88
+ */
89
+ declare function exampleMultipleNodes(): void;
90
+ /**
91
+ * Example 5: Generic event handler with type narrowing
92
+ */
93
+ declare function exampleEventHandler(event: GraphConverter.Event): void;
94
+ /**
95
+ * Example 6: Type-safe event name checking
96
+ */
97
+ declare function exampleEventNameChecking(eventName: string): void;
98
+ /**
99
+ * Example 7: Integration with event validator
100
+ */
101
+ declare function exampleWithValidator(): Promise<void>;
102
+ export { exampleFullEventEmitter, exampleEventEmitterByName, GraphConverterService, exampleMultipleNodes, exampleEventHandler, exampleEventNameChecking, exampleWithValidator, };
103
+ //# sourceMappingURL=usage-example.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage-example.d.ts","sourceRoot":"","sources":["../../src/codegen/usage-example.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,kBAAU,cAAc,CAAC;IACvB,UAAiB,iBAAiB;QAChC,IAAI,EAAE,oBAAoB,CAAC;QAC3B,UAAU,EAAE;YACV,kBAAkB,EAAE,MAAM,CAAC;YAC3B,kBAAkB,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH;IAED,UAAiB,kBAAkB;QACjC,IAAI,EAAE,qBAAqB,CAAC;QAC5B,UAAU,EAAE;YACV,oBAAoB,EAAE,MAAM,CAAC;YAC7B,oBAAoB,EAAE,MAAM,CAAC;YAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;SACxB,CAAC;KACH;IAED,UAAiB,eAAe;QAC9B,IAAI,EAAE,kBAAkB,CAAC;QACzB,UAAU,EAAE;YACV,eAAe,EAAE,MAAM,CAAC;YACxB,aAAa,CAAC,EAAE,MAAM,CAAC;SACxB,CAAC;KACH;IAED,UAAiB,yBAAyB;QACxC,IAAI,EAAE,4BAA4B,CAAC;QACnC,UAAU,EAAE;YACV,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;KACH;IAED,UAAiB,yBAAyB;QACxC,IAAI,EAAE,4BAA4B,CAAC;QACnC,UAAU,EAAE;YACV,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;KACH;IAED,KAAY,KAAK,GACb,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,yBAAyB,GACzB,yBAAyB,CAAC;IAE9B,KAAY,SAAS,GACjB,oBAAoB,GACpB,4BAA4B,GAC5B,4BAA4B,GAC5B,qBAAqB,GACrB,kBAAkB,CAAC;CACxB;AAsBD,KAAK,iBAAiB,CAAC,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,IAAI,CACzF,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EAE5B,SAAS,EAAE,KAAK,EAChB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC,YAAY,CAAC,KACvD,IAAI,CAAC;AAEV;;GAEG;AACH,iBAAS,uBAAuB,SAiD/B;AAED;;GAEG;AACH,iBAAS,yBAAyB,SAiCjC;AAED;;GAEG;AACH,cAAM,qBAAqB;IACzB,OAAO,CAAC,IAAI,CAA0C;gBAE1C,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,CAAC;IAI5D,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE;CAuB7D;AAED;;GAEG;AACH,iBAAS,oBAAoB,SAwB5B;AAED;;GAEG;AACH,iBAAS,mBAAmB,CAAC,KAAK,EAAE,cAAc,CAAC,KAAK,QAsBvD;AAED;;GAEG;AACH,iBAAS,wBAAwB,CAAC,SAAS,EAAE,MAAM,QAMlD;AAaD;;GAEG;AACH,iBAAe,oBAAoB,kBA+BlC;AAED,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,GACrB,CAAC"}