@elevasis/core 0.7.1 → 0.8.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 (473) hide show
  1. package/package.json +1 -1
  2. package/src/README.md +41 -41
  3. package/src/__tests__/publish.test.ts +18 -18
  4. package/src/__tests__/{template-foundations-compatibility.test.ts → template-core-compatibility.test.ts} +99 -99
  5. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +1135 -1131
  6. package/src/_gen/__tests__/scaffold-contracts.test.ts +53 -53
  7. package/src/_gen/scaffold-contracts.ts +45 -45
  8. package/src/auth/multi-tenancy/credentials/README.md +38 -38
  9. package/src/auth/multi-tenancy/credentials/index.ts +6 -6
  10. package/src/auth/multi-tenancy/credentials/server/encryption.ts +39 -39
  11. package/src/auth/multi-tenancy/credentials/server/service.ts +60 -60
  12. package/src/auth/multi-tenancy/index.ts +17 -17
  13. package/src/auth/multi-tenancy/invitations/api-schemas.ts +107 -107
  14. package/src/auth/multi-tenancy/invitations/index.ts +37 -37
  15. package/src/auth/multi-tenancy/invitations/invitation.ts +86 -86
  16. package/src/auth/multi-tenancy/invitations/server/index.ts +25 -25
  17. package/src/auth/multi-tenancy/invitations/server/transforms.ts +24 -24
  18. package/src/auth/multi-tenancy/invitations/server/workos.ts +24 -24
  19. package/src/auth/multi-tenancy/invitations/supabase.ts +50 -50
  20. package/src/auth/multi-tenancy/memberships/api-schemas.ts +126 -126
  21. package/src/auth/multi-tenancy/memberships/index.ts +21 -21
  22. package/src/auth/multi-tenancy/memberships/membership.ts +138 -138
  23. package/src/auth/multi-tenancy/memberships/server/index.ts +15 -15
  24. package/src/auth/multi-tenancy/memberships/server/transforms.ts +32 -32
  25. package/src/auth/multi-tenancy/memberships/server/workos.ts +21 -21
  26. package/src/auth/multi-tenancy/memberships/supabase.ts +46 -46
  27. package/src/auth/multi-tenancy/organizations/api-schemas.ts +128 -128
  28. package/src/auth/multi-tenancy/organizations/index.ts +23 -23
  29. package/src/auth/multi-tenancy/organizations/organization.ts +24 -24
  30. package/src/auth/multi-tenancy/organizations/server/index.ts +10 -10
  31. package/src/auth/multi-tenancy/organizations/server/transforms.ts +35 -35
  32. package/src/auth/multi-tenancy/organizations/server/workos.ts +20 -20
  33. package/src/auth/multi-tenancy/types.ts +83 -83
  34. package/src/auth/multi-tenancy/users/api-schemas.ts +194 -194
  35. package/src/auth/multi-tenancy/users/index.ts +27 -27
  36. package/src/auth/multi-tenancy/users/server/index.ts +19 -19
  37. package/src/auth/multi-tenancy/users/server/transforms.ts +21 -21
  38. package/src/auth/multi-tenancy/users/server/workos.ts +16 -16
  39. package/src/auth/multi-tenancy/users/user.ts +65 -65
  40. package/src/business/README.md +52 -52
  41. package/src/business/__tests__/entities-published.test.ts +33 -33
  42. package/src/business/acquisition/api-schemas.ts +759 -759
  43. package/src/business/acquisition/index.ts +109 -109
  44. package/src/business/acquisition/types.ts +402 -402
  45. package/src/business/base-entities.test.ts +481 -481
  46. package/src/business/base-entities.ts +241 -241
  47. package/src/business/entities-published.ts +24 -24
  48. package/src/business/index.ts +15 -15
  49. package/src/business/pdf/browser/pdfmake-browser.ts +229 -229
  50. package/src/business/pdf/index.ts +10 -10
  51. package/src/business/pdf/server/index.ts +21 -21
  52. package/src/business/pdf/server/themes/default.ts +8 -8
  53. package/src/business/pdf/server/themes/index.ts +9 -9
  54. package/src/business/pdf/server/themes/types.ts +8 -8
  55. package/src/business/pdf/types.ts +272 -272
  56. package/src/business/projects/index.ts +2 -2
  57. package/src/business/projects/sse-events.ts +21 -21
  58. package/src/business/projects/types.ts +89 -89
  59. package/src/business/sales/api-schemas.ts +75 -75
  60. package/src/business/seo/__tests__/linking.test.ts +549 -549
  61. package/src/business/seo/__tests__/types.test.ts +404 -404
  62. package/src/business/seo/index.ts +2 -2
  63. package/src/business/seo/linking.ts +281 -281
  64. package/src/business/seo/types.ts +199 -199
  65. package/src/commands/queue/index.ts +3 -3
  66. package/src/commands/queue/schemas.test.ts +593 -593
  67. package/src/commands/queue/schemas.ts +125 -125
  68. package/src/commands/queue/sse-events.ts +61 -61
  69. package/src/commands/queue/types/action.ts +52 -52
  70. package/src/commands/queue/types/checkpoint.ts +44 -44
  71. package/src/commands/queue/types/index.ts +7 -7
  72. package/src/commands/queue/types/task.ts +116 -116
  73. package/src/commands/queue/types.ts +14 -14
  74. package/src/content/distribution-metadata.ts +61 -61
  75. package/src/content/index.ts +10 -10
  76. package/src/deployments/index.ts +22 -22
  77. package/src/execution/core/__tests__/archived-logs.test.ts +72 -72
  78. package/src/execution/core/index.ts +11 -11
  79. package/src/execution/core/runner-types.ts +80 -80
  80. package/src/execution/core/server/environment.ts +31 -31
  81. package/src/execution/core/sse-executions.ts +119 -119
  82. package/src/execution/core/types.ts +29 -29
  83. package/src/execution/engine/__tests__/fixtures/test-agents.ts +4 -4
  84. package/src/execution/engine/__tests__/timeout.test.ts +565 -565
  85. package/src/execution/engine/agent/__tests__/errors.test.ts +508 -508
  86. package/src/execution/engine/agent/actions/__tests__/processor.test.ts +531 -531
  87. package/src/execution/engine/agent/actions/executor.ts +205 -205
  88. package/src/execution/engine/agent/actions/navigate-knowledge-executor.ts +230 -230
  89. package/src/execution/engine/agent/actions/processor.ts +116 -116
  90. package/src/execution/engine/agent/actions/types.ts +70 -70
  91. package/src/execution/engine/agent/core/agent.ts +810 -810
  92. package/src/execution/engine/agent/core/types.ts +155 -155
  93. package/src/execution/engine/agent/errors.ts +251 -251
  94. package/src/execution/engine/agent/index.ts +78 -78
  95. package/src/execution/engine/agent/knowledge-map/types.ts +106 -106
  96. package/src/execution/engine/agent/knowledge-map/utils.ts +101 -101
  97. package/src/execution/engine/agent/memory/__tests__/manager.test.ts +754 -754
  98. package/src/execution/engine/agent/memory/domains.ts +99 -99
  99. package/src/execution/engine/agent/memory/manager.ts +365 -365
  100. package/src/execution/engine/agent/memory/processor.ts +66 -66
  101. package/src/execution/engine/agent/memory/types.ts +90 -90
  102. package/src/execution/engine/agent/memory/utils.ts +134 -134
  103. package/src/execution/engine/agent/observability/logging.ts +467 -467
  104. package/src/execution/engine/agent/observability/types.ts +64 -64
  105. package/src/execution/engine/agent/reasoning/adapters/agent-adapter-helpers.ts +349 -349
  106. package/src/execution/engine/agent/reasoning/processor.ts +92 -92
  107. package/src/execution/engine/agent/reasoning/prompt-sections/base-actions.ts +134 -134
  108. package/src/execution/engine/agent/reasoning/prompt-sections/completion.ts +49 -49
  109. package/src/execution/engine/agent/reasoning/prompt-sections/knowledge-map.ts +93 -93
  110. package/src/execution/engine/agent/reasoning/prompt-sections/memory.ts +65 -65
  111. package/src/execution/engine/agent/reasoning/prompt-sections/tools.ts +44 -44
  112. package/src/execution/engine/agent/reasoning/request-builder.ts +169 -169
  113. package/src/execution/engine/agent/reasoning/types.ts +18 -18
  114. package/src/execution/engine/base/errors.ts +118 -118
  115. package/src/execution/engine/base/index.ts +2 -2
  116. package/src/execution/engine/base/logging.ts +31 -31
  117. package/src/execution/engine/base/serialization.ts +324 -324
  118. package/src/execution/engine/base/types.ts +126 -126
  119. package/src/execution/engine/base/utils.ts +41 -41
  120. package/src/execution/engine/index.ts +434 -434
  121. package/src/execution/engine/interface/index.ts +1 -1
  122. package/src/execution/engine/interface/types.ts +62 -62
  123. package/src/execution/engine/llm/__tests__/model-info.test.ts +50 -50
  124. package/src/execution/engine/llm/__tests__/model-validation.test.ts +321 -321
  125. package/src/execution/engine/llm/__tests__/response-schema-validator.test.ts +115 -115
  126. package/src/execution/engine/llm/adapters/__tests__/adapter-factory.test.ts +375 -375
  127. package/src/execution/engine/llm/adapters/__tests__/anthropic-adapter.test.ts +463 -463
  128. package/src/execution/engine/llm/adapters/__tests__/anthropic.integration.test.ts +177 -177
  129. package/src/execution/engine/llm/adapters/__tests__/google-adapter.test.ts +722 -722
  130. package/src/execution/engine/llm/adapters/__tests__/google.integration.test.ts +376 -376
  131. package/src/execution/engine/llm/adapters/__tests__/openai-adapter.test.ts +551 -551
  132. package/src/execution/engine/llm/adapters/__tests__/openrouter-adapter.test.ts +563 -563
  133. package/src/execution/engine/llm/adapters/__tests__/openrouter.integration.test.ts +105 -105
  134. package/src/execution/engine/llm/adapters/__tests__/universal-adapter.test.ts +537 -537
  135. package/src/execution/engine/llm/adapters/circuit-breaker.ts +147 -147
  136. package/src/execution/engine/llm/adapters/index.ts +17 -17
  137. package/src/execution/engine/llm/adapters/mock-adapter.ts +116 -116
  138. package/src/execution/engine/llm/adapters/server/adapter-factory.ts +130 -130
  139. package/src/execution/engine/llm/adapters/server/anthropic.ts +137 -137
  140. package/src/execution/engine/llm/adapters/server/google.ts +283 -283
  141. package/src/execution/engine/llm/adapters/server/index.ts +12 -12
  142. package/src/execution/engine/llm/adapters/server/openai.ts +206 -206
  143. package/src/execution/engine/llm/adapters/server/openrouter.ts +235 -235
  144. package/src/execution/engine/llm/adapters/universal-adapter.ts +230 -230
  145. package/src/execution/engine/llm/errors.ts +186 -186
  146. package/src/execution/engine/llm/model-info.ts +332 -332
  147. package/src/execution/engine/llm/response-schema-validator.ts +113 -113
  148. package/src/execution/engine/llm/types.ts +86 -86
  149. package/src/execution/engine/test-utils/index.ts +6 -6
  150. package/src/execution/engine/test-utils/mocks.ts +56 -56
  151. package/src/execution/engine/tools/integration/base-integration-adapter.ts +50 -50
  152. package/src/execution/engine/tools/integration/index.ts +53 -53
  153. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/anymailfinder-adapter.ts +73 -73
  154. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/anymailfinder-tools.ts +209 -209
  155. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/fetch/find-company-email/index.ts +82 -82
  156. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/fetch/find-decision-maker-email/index.ts +122 -122
  157. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/fetch/find-person-email/index.ts +89 -89
  158. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/fetch/verify-email/index.ts +84 -84
  159. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/index.ts +16 -16
  160. package/src/execution/engine/tools/integration/server/adapters/apify/__tests__/apify-run-actor.integration.test.ts +293 -293
  161. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.ts +100 -100
  162. package/src/execution/engine/tools/integration/server/adapters/apify/apify-tools.ts +217 -217
  163. package/src/execution/engine/tools/integration/server/adapters/apify/fetch/get-dataset-items/index.ts +92 -92
  164. package/src/execution/engine/tools/integration/server/adapters/apify/fetch/run-actor/index.ts +218 -218
  165. package/src/execution/engine/tools/integration/server/adapters/apify/fetch/start-actor/index.ts +87 -87
  166. package/src/execution/engine/tools/integration/server/adapters/apify/index.ts +11 -11
  167. package/src/execution/engine/tools/integration/server/adapters/attio/__tests__/attio-crud.integration.test.ts +361 -361
  168. package/src/execution/engine/tools/integration/server/adapters/attio/attio-adapter.ts +162 -162
  169. package/src/execution/engine/tools/integration/server/adapters/attio/attio-tools.ts +594 -594
  170. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/create-attribute/index.ts +214 -214
  171. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/create-note/index.ts +152 -152
  172. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/create-record/index.ts +141 -141
  173. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/delete-note/index.ts +86 -86
  174. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/delete-record/index.ts +105 -105
  175. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/get-record/index.ts +118 -118
  176. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-attributes/index.ts +165 -165
  177. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-notes/index.ts +96 -96
  178. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-objects/index.ts +104 -104
  179. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-records/index.ts +156 -156
  180. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/update-attribute/index.ts +220 -220
  181. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/update-record/index.ts +140 -140
  182. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/utils/types.ts +146 -146
  183. package/src/execution/engine/tools/integration/server/adapters/attio/index.ts +31 -31
  184. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-adapter.ts +210 -210
  185. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-tools.ts +104 -104
  186. package/src/execution/engine/tools/integration/server/adapters/google-sheets/__tests__/google-sheets.integration.test.ts +261 -261
  187. package/src/execution/engine/tools/integration/server/adapters/google-sheets/google-sheets-adapter.ts +1189 -1189
  188. package/src/execution/engine/tools/integration/server/adapters/google-sheets/google-sheets-tools.ts +641 -641
  189. package/src/execution/engine/tools/integration/server/adapters/google-sheets/index.ts +18 -18
  190. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/activate-campaign/index.ts +86 -86
  191. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/add-to-campaign/__tests__/index.test.ts +289 -289
  192. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/add-to-campaign/index.ts +154 -154
  193. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/bulk-add-leads/__tests__/index.test.ts +325 -325
  194. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/bulk-add-leads/index.ts +153 -153
  195. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/bulk-delete-leads/index.ts +84 -84
  196. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/create-campaign/index.ts +125 -125
  197. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/create-inbox-test/index.ts +107 -107
  198. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/delete-campaign/index.ts +85 -85
  199. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-account-health/index.ts +91 -91
  200. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-campaign/index.ts +92 -92
  201. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-campaign-analytics/__tests__/index.test.ts +195 -195
  202. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-campaign-analytics/index.ts +113 -113
  203. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-daily-campaign-analytics/index.ts +104 -104
  204. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-emails/index.ts +155 -155
  205. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-step-analytics/__tests__/index.test.ts +196 -196
  206. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-step-analytics/index.ts +102 -102
  207. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/list-campaigns/__tests__/index.test.ts +189 -189
  208. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/list-campaigns/index.ts +87 -87
  209. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/list-leads/index.ts +112 -112
  210. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/patch-lead/index.ts +76 -76
  211. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/pause-campaign/index.ts +86 -86
  212. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/remove-from-subsequence/index.ts +98 -98
  213. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/send-reply/index.ts +126 -126
  214. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/update-campaign/__tests__/index.test.ts +193 -193
  215. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/update-campaign/index.ts +99 -99
  216. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/update-interest-status/__tests__/index.test.ts +621 -621
  217. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/update-interest-status/index.ts +125 -125
  218. package/src/execution/engine/tools/integration/server/adapters/instantly/index.ts +29 -29
  219. package/src/execution/engine/tools/integration/server/adapters/instantly/instantly-adapter.ts +178 -178
  220. package/src/execution/engine/tools/integration/server/adapters/instantly/instantly-tools.ts +1473 -1473
  221. package/src/execution/engine/tools/integration/server/adapters/millionverifier/fetch/check-credits/index.ts +59 -59
  222. package/src/execution/engine/tools/integration/server/adapters/millionverifier/fetch/verify-email/index.ts +102 -102
  223. package/src/execution/engine/tools/integration/server/adapters/millionverifier/index.ts +17 -17
  224. package/src/execution/engine/tools/integration/server/adapters/millionverifier/millionverifier-adapter.ts +80 -80
  225. package/src/execution/engine/tools/integration/server/adapters/millionverifier/millionverifier-tools.ts +102 -102
  226. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/get-email/index.ts +102 -102
  227. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.ts +134 -134
  228. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/utils/types.ts +75 -75
  229. package/src/execution/engine/tools/integration/server/adapters/resend/index.ts +27 -27
  230. package/src/execution/engine/tools/integration/server/adapters/resend/resend-adapter.ts +108 -108
  231. package/src/execution/engine/tools/integration/server/adapters/resend/resend-tools.ts +132 -132
  232. package/src/execution/engine/tools/integration/server/adapters/signature-api/fetch/create-envelope/index.ts +274 -274
  233. package/src/execution/engine/tools/integration/server/adapters/signature-api/fetch/download-document/index.ts +230 -230
  234. package/src/execution/engine/tools/integration/server/adapters/signature-api/fetch/get-envelope/index.ts +133 -133
  235. package/src/execution/engine/tools/integration/server/adapters/signature-api/fetch/void-envelope/index.ts +90 -90
  236. package/src/execution/engine/tools/integration/server/adapters/stripe/fetch/utils/types.ts +210 -210
  237. package/src/execution/engine/tools/integration/server/adapters/stripe/stripe-adapter.ts +517 -517
  238. package/src/execution/engine/tools/integration/server/adapters/stripe/stripe-tools.ts +309 -309
  239. package/src/execution/engine/tools/integration/server/adapters/tomba/fetch/domain-search/index.ts +133 -133
  240. package/src/execution/engine/tools/integration/server/adapters/tomba/fetch/email-finder/index.ts +122 -122
  241. package/src/execution/engine/tools/integration/server/adapters/tomba/fetch/email-verifier/index.ts +111 -111
  242. package/src/execution/engine/tools/integration/server/adapters/tomba/index.ts +11 -11
  243. package/src/execution/engine/tools/integration/server/adapters/tomba/tomba-adapter.ts +78 -78
  244. package/src/execution/engine/tools/integration/server/adapters/tomba/tomba-tools.ts +222 -222
  245. package/src/execution/engine/tools/integration/server/index.ts +61 -61
  246. package/src/execution/engine/tools/integration/service.ts +161 -161
  247. package/src/execution/engine/tools/integration/tool.ts +253 -253
  248. package/src/execution/engine/tools/integration/types/anymailfinder.ts +74 -74
  249. package/src/execution/engine/tools/integration/types/apify.ts +92 -92
  250. package/src/execution/engine/tools/integration/types/index.ts +19 -19
  251. package/src/execution/engine/tools/integration/types/instantly.ts +557 -557
  252. package/src/execution/engine/tools/integration/types/millionverifier.ts +56 -56
  253. package/src/execution/engine/tools/integration/types/stripe.ts +162 -162
  254. package/src/execution/engine/tools/integration/types/tomba.ts +94 -94
  255. package/src/execution/engine/tools/lead-service-types.ts +884 -884
  256. package/src/execution/engine/tools/llm/index.ts +11 -11
  257. package/src/execution/engine/tools/llm/server/index.ts +8 -8
  258. package/src/execution/engine/tools/llm/server/llm-call-tool.ts +118 -118
  259. package/src/execution/engine/tools/platform/__tests__/pdf.test.ts +441 -441
  260. package/src/execution/engine/tools/platform/acquisition/company-tools.ts +248 -248
  261. package/src/execution/engine/tools/platform/acquisition/contact-tools.ts +319 -319
  262. package/src/execution/engine/tools/platform/acquisition/index.ts +43 -43
  263. package/src/execution/engine/tools/platform/acquisition/list-tools.ts +148 -148
  264. package/src/execution/engine/tools/platform/acquisition/types.ts +260 -260
  265. package/src/execution/engine/tools/platform/email/index.ts +122 -122
  266. package/src/execution/engine/tools/platform/email/types.ts +96 -96
  267. package/src/execution/engine/tools/platform/index.ts +157 -157
  268. package/src/execution/engine/tools/platform/notification.ts +81 -81
  269. package/src/execution/engine/tools/platform/pdf/index.ts +110 -110
  270. package/src/execution/engine/tools/platform/pdf/types.ts +77 -77
  271. package/src/execution/engine/tools/platform/scheduler.ts +87 -87
  272. package/src/execution/engine/tools/platform/storage/index.ts +370 -370
  273. package/src/execution/engine/tools/platform/types.ts +148 -148
  274. package/src/execution/engine/tools/registry.ts +700 -700
  275. package/src/execution/engine/tools/tool-maps.ts +786 -786
  276. package/src/execution/engine/tools/types.ts +233 -233
  277. package/src/execution/engine/workflow/__tests__/errors.test.ts +139 -139
  278. package/src/execution/engine/workflow/errors.ts +63 -63
  279. package/src/execution/engine/workflow/helpers/index.ts +11 -11
  280. package/src/execution/engine/workflow/helpers/server/index.ts +8 -8
  281. package/src/execution/engine/workflow/helpers/server/llm-call.ts +93 -93
  282. package/src/execution/engine/workflow/index.ts +19 -19
  283. package/src/execution/engine/workflow/log-truncate.ts +26 -26
  284. package/src/execution/engine/workflow/logging.ts +191 -191
  285. package/src/execution/engine/workflow/types.ts +182 -182
  286. package/src/execution/engine/workflow/utils.ts +280 -280
  287. package/src/execution/engine/workflow/workflow.ts +168 -168
  288. package/src/execution/index.ts +3 -3
  289. package/src/execution/scheduler/__tests__/api-schemas.test.ts +733 -733
  290. package/src/execution/scheduler/__tests__/utils.test.ts +1009 -1009
  291. package/src/execution/scheduler/api-schemas.ts +296 -296
  292. package/src/execution/scheduler/index.ts +50 -50
  293. package/src/execution/scheduler/schemas.ts +264 -264
  294. package/src/execution/scheduler/types.ts +111 -111
  295. package/src/execution/scheduler/utils.ts +364 -364
  296. package/src/forms/index.ts +7 -7
  297. package/src/forms/schemas.ts +69 -69
  298. package/src/forms/types.ts +70 -70
  299. package/src/index.ts +71 -60
  300. package/src/integrations/credentials/__tests__/schemas.test.ts +82 -82
  301. package/src/integrations/credentials/__tests__/utils.test.ts +144 -144
  302. package/src/integrations/credentials/api-schemas.ts +143 -143
  303. package/src/integrations/credentials/index.ts +32 -32
  304. package/src/integrations/credentials/schemas.ts +164 -164
  305. package/src/integrations/credentials/utils.ts +59 -59
  306. package/src/integrations/oauth/__tests__/provider-registry.test.ts +59 -59
  307. package/src/integrations/oauth/api-schemas.ts +92 -92
  308. package/src/integrations/oauth/index.ts +19 -19
  309. package/src/integrations/oauth/provider-registry.ts +61 -61
  310. package/src/integrations/oauth/server/__tests__/refresh-concurrent.test.ts +183 -183
  311. package/src/integrations/oauth/server/__tests__/refresh.test.ts +577 -577
  312. package/src/integrations/oauth/server/credentials.ts +39 -39
  313. package/src/integrations/oauth/server/refresh.ts +214 -214
  314. package/src/integrations/oauth/types.ts +34 -34
  315. package/src/integrations/webhook-endpoints/__tests__/api-schemas.test.ts +318 -318
  316. package/src/integrations/webhook-endpoints/api-schemas.ts +102 -102
  317. package/src/integrations/webhook-endpoints/index.ts +28 -28
  318. package/src/integrations/webhook-endpoints/types.ts +51 -51
  319. package/src/operations/activities/api-schemas.ts +79 -79
  320. package/src/operations/activities/index.ts +9 -9
  321. package/src/operations/activities/sse-events.ts +30 -30
  322. package/src/operations/activities/types.ts +63 -63
  323. package/src/operations/debug-logs/client.ts +60 -60
  324. package/src/operations/debug-logs/debug-logger.ts +83 -83
  325. package/src/operations/debug-logs/index.ts +8 -8
  326. package/src/operations/debug-logs/server.ts +19 -19
  327. package/src/operations/debug-logs/types.ts +33 -33
  328. package/src/operations/index.ts +50 -50
  329. package/src/operations/notifications/api-schemas.ts +91 -91
  330. package/src/operations/notifications/index.ts +3 -3
  331. package/src/operations/notifications/sse-events.ts +21 -21
  332. package/src/operations/notifications/types.ts +47 -47
  333. package/src/operations/observability/__tests__/openrouter-cost-flow.test.ts +297 -297
  334. package/src/operations/observability/__tests__/utils.test.ts +54 -54
  335. package/src/operations/observability/ai-usage-collector.ts +64 -64
  336. package/src/operations/observability/index.ts +13 -13
  337. package/src/operations/observability/metrics-collector.ts +49 -49
  338. package/src/operations/observability/schemas.ts +39 -39
  339. package/src/operations/observability/types.ts +463 -463
  340. package/src/operations/observability/utils.ts +77 -77
  341. package/src/operations/sessions/__tests__/manager.test.ts +821 -821
  342. package/src/operations/sessions/index.ts +26 -26
  343. package/src/operations/sessions/server/manager.ts +90 -90
  344. package/src/operations/sessions/server/session.ts +180 -180
  345. package/src/operations/sessions/types.ts +98 -98
  346. package/src/operations/triggers/index.ts +12 -12
  347. package/src/operations/triggers/webhook/definitions/instantly-account-error.ts +44 -44
  348. package/src/operations/triggers/webhook/definitions/instantly-auto-reply-received.ts +51 -51
  349. package/src/operations/triggers/webhook/definitions/instantly-campaign-completed.ts +45 -45
  350. package/src/operations/triggers/webhook/definitions/instantly-email-bounced.ts +49 -49
  351. package/src/operations/triggers/webhook/definitions/instantly-lead-unsubscribed.ts +45 -45
  352. package/src/operations/triggers/webhook/definitions/instantly-reply-received.ts +54 -54
  353. package/src/operations/triggers/webhook/index.ts +35 -35
  354. package/src/operations/triggers/webhook/types.ts +74 -74
  355. package/src/organization-model/README.md +97 -97
  356. package/src/organization-model/__tests__/defaults.test.ts +175 -175
  357. package/src/organization-model/__tests__/domains/customers.test.ts +295 -295
  358. package/src/organization-model/__tests__/domains/goals.test.ts +479 -479
  359. package/src/organization-model/__tests__/domains/identity.test.ts +279 -279
  360. package/src/organization-model/__tests__/domains/navigation.test.ts +212 -212
  361. package/src/organization-model/__tests__/domains/offerings.test.ts +419 -419
  362. package/src/organization-model/__tests__/domains/operations.test.ts +203 -203
  363. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +362 -362
  364. package/src/organization-model/__tests__/domains/roles.test.ts +347 -347
  365. package/src/organization-model/__tests__/domains/statuses.test.ts +243 -243
  366. package/src/organization-model/__tests__/foundation.test.ts +105 -105
  367. package/src/organization-model/__tests__/graph.test.ts +894 -894
  368. package/src/organization-model/__tests__/resolve.test.ts +690 -690
  369. package/src/organization-model/__tests__/schema.test.ts +407 -407
  370. package/src/organization-model/contracts.ts +14 -14
  371. package/src/organization-model/defaults.ts +148 -148
  372. package/src/organization-model/domains/branding.ts +22 -22
  373. package/src/organization-model/domains/customers.ts +75 -75
  374. package/src/organization-model/domains/features.ts +22 -22
  375. package/src/organization-model/domains/goals.ts +80 -80
  376. package/src/organization-model/domains/identity.ts +94 -94
  377. package/src/organization-model/domains/navigation.ts +391 -391
  378. package/src/organization-model/domains/offerings.ts +66 -66
  379. package/src/organization-model/domains/operations.ts +85 -85
  380. package/src/organization-model/domains/projects.ts +48 -48
  381. package/src/organization-model/domains/prospecting.ts +33 -33
  382. package/src/organization-model/domains/roles.ts +55 -55
  383. package/src/organization-model/domains/sales.ts +94 -94
  384. package/src/organization-model/domains/shared.ts +62 -62
  385. package/src/organization-model/domains/statuses.ts +130 -130
  386. package/src/organization-model/foundation.ts +97 -97
  387. package/src/organization-model/graph/build.ts +399 -399
  388. package/src/organization-model/graph/index.ts +4 -4
  389. package/src/organization-model/graph/schema.ts +48 -48
  390. package/src/organization-model/graph/types.ts +40 -40
  391. package/src/organization-model/index.ts +13 -13
  392. package/src/organization-model/organization-graph.mdx +272 -272
  393. package/src/organization-model/organization-model.mdx +320 -320
  394. package/src/organization-model/published.ts +85 -85
  395. package/src/organization-model/resolve.ts +66 -66
  396. package/src/organization-model/schema.ts +287 -287
  397. package/src/organization-model/types.ts +46 -46
  398. package/src/platform/api/index.ts +1 -1
  399. package/src/platform/api/types.ts +35 -35
  400. package/src/platform/constants/http.ts +37 -37
  401. package/src/platform/constants/index.ts +5 -5
  402. package/src/platform/constants/limits.ts +32 -32
  403. package/src/platform/constants/resilience.ts +51 -51
  404. package/src/platform/constants/timeouts.ts +20 -20
  405. package/src/platform/constants/versions.ts +3 -3
  406. package/src/platform/registry/__tests__/resource-registry-static.test.ts +347 -347
  407. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +1028 -1028
  408. package/src/platform/registry/__tests__/resource-registry.list-executable.test.ts +393 -393
  409. package/src/platform/registry/__tests__/resource-registry.test.ts +2005 -2005
  410. package/src/platform/registry/__tests__/serialization.test.ts +1127 -1127
  411. package/src/platform/registry/command-view.ts +180 -180
  412. package/src/platform/registry/domains.ts +165 -165
  413. package/src/platform/registry/index.ts +93 -93
  414. package/src/platform/registry/reserved.ts +24 -24
  415. package/src/platform/registry/resource-metadata.ts +59 -59
  416. package/src/platform/registry/resource-registry.command-queue-groups.test.ts +129 -129
  417. package/src/platform/registry/resource-registry.ts +876 -876
  418. package/src/platform/registry/serialization.ts +273 -273
  419. package/src/platform/registry/serialized-types.ts +231 -231
  420. package/src/platform/registry/stats-types.ts +66 -66
  421. package/src/platform/registry/types.ts +404 -404
  422. package/src/platform/registry/validation.ts +513 -513
  423. package/src/platform/resilience/__tests__/rate-limiter.test.ts +471 -471
  424. package/src/platform/resilience/circuit-breaker.ts +164 -164
  425. package/src/platform/resilience/errors.ts +68 -68
  426. package/src/platform/resilience/http-error-mapper.ts +129 -129
  427. package/src/platform/resilience/index.ts +93 -93
  428. package/src/platform/resilience/rate-limiter-types.ts +46 -46
  429. package/src/platform/resilience/rate-limiter.ts +140 -140
  430. package/src/platform/resilience/retry.ts +89 -89
  431. package/src/platform/resilience/timeout.ts +63 -63
  432. package/src/platform/sse/events.ts +37 -37
  433. package/src/platform/sse/index.ts +7 -7
  434. package/src/platform/utils/__tests__/validation.test.ts +1083 -1083
  435. package/src/platform/utils/currency.ts +96 -96
  436. package/src/platform/utils/debounce.ts +52 -52
  437. package/src/platform/utils/error.ts +41 -41
  438. package/src/platform/utils/hmac.test.ts +97 -97
  439. package/src/platform/utils/index.ts +32 -32
  440. package/src/platform/utils/server/betterstack-logger.ts +210 -210
  441. package/src/platform/utils/server/hmac.ts +44 -44
  442. package/src/platform/utils/server/unsubscribe.ts +111 -111
  443. package/src/platform/utils/token-counter.ts +96 -96
  444. package/src/platform/utils/validation.ts +425 -425
  445. package/src/projects/api-schemas.ts +268 -268
  446. package/src/published.ts +1 -1
  447. package/src/reference/_generated/contracts.md +607 -607
  448. package/src/reference/glossary.md +105 -105
  449. package/src/requests/__tests__/api-schemas.test.ts +277 -277
  450. package/src/requests/api-schemas.ts +83 -83
  451. package/src/requests/index.ts +1 -1
  452. package/src/scaffold-registry/__tests__/index.test.ts +17 -0
  453. package/src/scaffold-registry/__tests__/schema.test.ts +329 -230
  454. package/src/scaffold-registry/index.ts +205 -189
  455. package/src/scaffold-registry/schema.ts +196 -128
  456. package/src/server.ts +272 -272
  457. package/src/supabase/database.types.ts +2719 -2719
  458. package/src/supabase/helpers.ts +20 -20
  459. package/src/supabase/index.ts +52 -52
  460. package/src/supabase/server/client.ts +58 -58
  461. package/src/test-utils/README.md +38 -38
  462. package/src/test-utils/browser-mocks.ts +54 -54
  463. package/src/test-utils/fixtures/api-keys.ts +52 -52
  464. package/src/test-utils/fixtures/index.ts +4 -4
  465. package/src/test-utils/fixtures/memberships.ts +80 -80
  466. package/src/test-utils/fixtures/organizations.ts +69 -69
  467. package/src/test-utils/fixtures/users.ts +79 -79
  468. package/src/test-utils/index.ts +11 -11
  469. package/src/test-utils/mocks/index.ts +2 -2
  470. package/src/test-utils/mocks/supabase.ts +142 -142
  471. package/src/test-utils/mocks/workos.ts +108 -108
  472. package/src/test-utils/rls/RLSTestContext.ts +556 -556
  473. package/src/test-utils/rls/index.ts +1 -1
@@ -1,894 +1,894 @@
1
- import { describe, expect, it } from 'vitest'
2
- import { buildOrganizationGraph } from '../graph'
3
- import { defineOrganizationModel, resolveOrganizationModel } from '../resolve'
4
-
5
- describe('organization-graph', () => {
6
- it('derives semantic graph nodes and edges from the organization model', () => {
7
- const model = resolveOrganizationModel(
8
- defineOrganizationModel({
9
- branding: {
10
- organizationName: 'Acme',
11
- productName: 'Acme OS',
12
- shortName: 'Acme'
13
- }
14
- })
15
- )
16
-
17
- const graph = buildOrganizationGraph({ organizationModel: model })
18
-
19
- expect(graph.version).toBe(1)
20
- expect(graph.organizationModelVersion).toBe(1)
21
-
22
- const feature = graph.nodes.find((node) => node.id === 'feature:operations')
23
- expect(feature).toMatchObject({
24
- kind: 'feature',
25
- sourceId: 'operations',
26
- label: 'Operations',
27
- enabled: true,
28
- featureId: 'operations'
29
- })
30
-
31
- const disabledFeature = graph.nodes.find((node) => node.id === 'feature:seo')
32
- expect(disabledFeature).toMatchObject({
33
- kind: 'feature',
34
- sourceId: 'seo',
35
- enabled: false
36
- })
37
-
38
- // Features now carry semantic data directly (no separate domain nodes)
39
- const crmFeature = graph.nodes.find((node) => node.id === 'feature:crm')
40
- expect(crmFeature).toMatchObject({
41
- kind: 'feature',
42
- sourceId: 'crm',
43
- label: 'CRM'
44
- })
45
-
46
- expect(graph.nodes.find((node) => node.id === 'surface:crm.pipeline')).toMatchObject({
47
- kind: 'surface',
48
- sourceId: 'crm.pipeline',
49
- surfaceType: 'graph'
50
- })
51
-
52
- expect(graph.nodes.find((node) => node.id === 'entity:crm.deal')).toMatchObject({
53
- kind: 'entity',
54
- sourceId: 'crm.deal',
55
- label: 'crm.deal'
56
- })
57
-
58
- expect(graph.nodes.find((node) => node.id === 'capability:crm.pipeline.manage')).toMatchObject({
59
- kind: 'capability',
60
- sourceId: 'crm.pipeline.manage',
61
- label: 'crm.pipeline.manage'
62
- })
63
-
64
- expect(graph.edges).toEqual(
65
- expect.arrayContaining([
66
- expect.objectContaining({
67
- kind: 'contains',
68
- sourceId: 'organization-model',
69
- targetId: 'feature:crm'
70
- }),
71
- expect.objectContaining({
72
- kind: 'exposes',
73
- sourceId: 'feature:crm',
74
- targetId: 'surface:crm.pipeline'
75
- }),
76
- expect.objectContaining({
77
- kind: 'references',
78
- sourceId: 'surface:crm.pipeline',
79
- targetId: 'feature:crm'
80
- })
81
- ])
82
- )
83
- })
84
-
85
- describe('feature labels', () => {
86
- it('uses the feature label directly from the unified features array', () => {
87
- const model = resolveOrganizationModel(
88
- defineOrganizationModel({
89
- branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' }
90
- })
91
- )
92
-
93
- const graph = buildOrganizationGraph({ organizationModel: model })
94
-
95
- // Verify all default features have their labels from the unified feature definitions
96
- const expectedLabels: Record<string, string> = {
97
- crm: 'CRM',
98
- 'lead-gen': 'Lead Gen',
99
- projects: 'Projects',
100
- operations: 'Operations',
101
- monitoring: 'Monitoring',
102
- settings: 'Settings',
103
- seo: 'SEO'
104
- }
105
-
106
- for (const [featureId, expectedLabel] of Object.entries(expectedLabels)) {
107
- const node = graph.nodes.find((n) => n.id === `feature:${featureId}`)
108
- expect(node, `feature node for '${featureId}' should exist`).toBeDefined()
109
- expect(node?.label).toBe(expectedLabel)
110
- }
111
- })
112
-
113
- it('uses the overridden label when a feature label is customized', () => {
114
- const model = resolveOrganizationModel(
115
- defineOrganizationModel({
116
- branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' },
117
- features: [
118
- {
119
- id: 'crm',
120
- label: 'Deals',
121
- enabled: true,
122
- entityIds: [],
123
- surfaceIds: ['crm.pipeline'],
124
- resourceIds: [],
125
- capabilityIds: []
126
- }
127
- ],
128
- navigation: {
129
- defaultSurfaceId: 'crm.pipeline',
130
- surfaces: [
131
- {
132
- id: 'crm.pipeline',
133
- label: 'Pipeline',
134
- path: '/crm/pipeline',
135
- surfaceType: 'graph',
136
- featureId: 'crm',
137
- featureIds: ['crm'],
138
- entityIds: [],
139
- resourceIds: [],
140
- capabilityIds: []
141
- }
142
- ],
143
- groups: [{ id: 'g', label: 'CRM', placement: 'primary', surfaceIds: ['crm.pipeline'] }]
144
- }
145
- })
146
- )
147
-
148
- const graph = buildOrganizationGraph({ organizationModel: model })
149
-
150
- const node = graph.nodes.find((n) => n.id === 'feature:crm')
151
- expect(node?.label).toBe('Deals')
152
- })
153
- })
154
-
155
- describe('resource node upsert merging', () => {
156
- it('keeps resourceMappings label and merges description from commandViewData', () => {
157
- const model = resolveOrganizationModel(
158
- defineOrganizationModel({
159
- features: [
160
- {
161
- id: 'operations',
162
- label: 'Operations',
163
- enabled: true,
164
- color: 'violet',
165
- entityIds: [],
166
- surfaceIds: ['operations.command-view'],
167
- resourceIds: ['workflow-order'],
168
- capabilityIds: []
169
- }
170
- ],
171
- navigation: {
172
- defaultSurfaceId: 'operations.command-view',
173
- surfaces: [
174
- {
175
- id: 'operations.command-view',
176
- label: 'Command View',
177
- path: '/operations/command-view',
178
- surfaceType: 'graph',
179
- featureId: 'operations',
180
- featureIds: ['operations'],
181
- entityIds: [],
182
- resourceIds: ['workflow-order'],
183
- capabilityIds: []
184
- }
185
- ],
186
- groups: [
187
- {
188
- id: 'primary-operations',
189
- label: 'Operations',
190
- placement: 'primary',
191
- surfaceIds: ['operations.command-view']
192
- }
193
- ]
194
- },
195
- resourceMappings: [
196
- {
197
- id: 'workflow-order-model',
198
- label: 'Order Workflow',
199
- resourceId: 'workflow-order',
200
- resourceType: 'workflow',
201
- featureIds: ['operations'],
202
- entityIds: [],
203
- surfaceIds: ['operations.command-view'],
204
- capabilityIds: []
205
- }
206
- ]
207
- })
208
- )
209
-
210
- const graph = buildOrganizationGraph({
211
- organizationModel: model,
212
- commandViewData: {
213
- workflows: [
214
- {
215
- resourceId: 'workflow-order',
216
- name: 'Order Workflow Runtime',
217
- description: 'Runtime description from commandViewData',
218
- version: '1.0.0',
219
- type: 'workflow',
220
- status: 'prod',
221
- domains: ['operations'],
222
- stepCount: 2,
223
- entryPoint: 'start'
224
- }
225
- ],
226
- agents: [],
227
- triggers: [],
228
- integrations: [],
229
- externalResources: [],
230
- humanCheckpoints: [],
231
- edges: []
232
- }
233
- })
234
-
235
- const resourceNodes = graph.nodes.filter((n) => n.id === 'resource:workflow-order')
236
- expect(resourceNodes).toHaveLength(1)
237
-
238
- const node = resourceNodes[0]
239
- expect(node.label).toBe('Order Workflow')
240
- expect(node.description).toBe('Runtime description from commandViewData')
241
- })
242
-
243
- it('preserves existing non-default label even when commandViewData provides a different name', () => {
244
- const model = resolveOrganizationModel(
245
- defineOrganizationModel({
246
- features: [
247
- {
248
- id: 'ops',
249
- label: 'Ops',
250
- enabled: true,
251
- color: 'blue',
252
- entityIds: [],
253
- surfaceIds: ['ops.view'],
254
- resourceIds: ['res-a'],
255
- capabilityIds: []
256
- }
257
- ],
258
- navigation: {
259
- defaultSurfaceId: 'ops.view',
260
- surfaces: [
261
- {
262
- id: 'ops.view',
263
- label: 'Ops View',
264
- path: '/ops/view',
265
- surfaceType: 'graph',
266
- featureId: 'operations',
267
- featureIds: ['ops'],
268
- entityIds: [],
269
- resourceIds: ['res-a'],
270
- capabilityIds: []
271
- }
272
- ],
273
- groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
274
- },
275
- resourceMappings: [
276
- {
277
- id: 'res-a-model',
278
- label: 'My Custom Label',
279
- resourceId: 'res-a',
280
- resourceType: 'workflow',
281
- featureIds: ['ops'],
282
- entityIds: [],
283
- surfaceIds: ['ops.view'],
284
- capabilityIds: []
285
- }
286
- ]
287
- })
288
- )
289
-
290
- const graph = buildOrganizationGraph({
291
- organizationModel: model,
292
- commandViewData: {
293
- workflows: [
294
- {
295
- resourceId: 'res-a',
296
- name: 'Runtime Name Should Not Override',
297
- description: 'desc',
298
- version: '1.0.0',
299
- type: 'workflow',
300
- status: 'prod',
301
- domains: ['ops'],
302
- stepCount: 1,
303
- entryPoint: 'start'
304
- }
305
- ],
306
- agents: [],
307
- triggers: [],
308
- integrations: [],
309
- externalResources: [],
310
- humanCheckpoints: [],
311
- edges: []
312
- }
313
- })
314
-
315
- const node = graph.nodes.find((n) => n.id === 'resource:res-a')
316
- expect(node?.label).toBe('My Custom Label')
317
- })
318
- })
319
-
320
- describe('de-duplication of graph elements', () => {
321
- it('creates only one feature node when multiple surfaces reference the same feature', () => {
322
- const model = resolveOrganizationModel(
323
- defineOrganizationModel({
324
- features: [
325
- {
326
- id: 'crm',
327
- label: 'CRM',
328
- enabled: true,
329
- color: 'blue',
330
- entityIds: [],
331
- surfaceIds: ['crm.pipeline', 'crm.accounts'],
332
- resourceIds: [],
333
- capabilityIds: []
334
- }
335
- ],
336
- navigation: {
337
- defaultSurfaceId: 'crm.pipeline',
338
- surfaces: [
339
- {
340
- id: 'crm.pipeline',
341
- label: 'Pipeline',
342
- path: '/crm/pipeline',
343
- surfaceType: 'graph',
344
- featureId: 'crm',
345
- featureIds: ['crm'],
346
- entityIds: [],
347
- resourceIds: [],
348
- capabilityIds: []
349
- },
350
- {
351
- id: 'crm.accounts',
352
- label: 'Accounts',
353
- path: '/crm/accounts',
354
- surfaceType: 'list',
355
- featureId: 'crm',
356
- featureIds: ['crm'],
357
- entityIds: [],
358
- resourceIds: [],
359
- capabilityIds: []
360
- }
361
- ],
362
- groups: [{ id: 'g', label: 'CRM', placement: 'primary', surfaceIds: ['crm.pipeline', 'crm.accounts'] }]
363
- }
364
- })
365
- )
366
-
367
- const graph = buildOrganizationGraph({ organizationModel: model })
368
-
369
- const featureNodes = graph.nodes.filter((n) => n.id === 'feature:crm')
370
- expect(featureNodes).toHaveLength(1)
371
- })
372
-
373
- it('creates only one entity node when the same entity appears in both a feature and a surface', () => {
374
- const model = resolveOrganizationModel(
375
- defineOrganizationModel({
376
- features: [
377
- {
378
- id: 'crm',
379
- label: 'CRM',
380
- enabled: true,
381
- color: 'blue',
382
- entityIds: ['crm.deal'],
383
- surfaceIds: ['crm.pipeline'],
384
- resourceIds: [],
385
- capabilityIds: []
386
- }
387
- ],
388
- navigation: {
389
- defaultSurfaceId: 'crm.pipeline',
390
- surfaces: [
391
- {
392
- id: 'crm.pipeline',
393
- label: 'Pipeline',
394
- path: '/crm/pipeline',
395
- surfaceType: 'graph',
396
- featureId: 'crm',
397
- featureIds: ['crm'],
398
- entityIds: ['crm.deal'],
399
- resourceIds: [],
400
- capabilityIds: []
401
- }
402
- ],
403
- groups: [{ id: 'g', label: 'CRM', placement: 'primary', surfaceIds: ['crm.pipeline'] }]
404
- }
405
- })
406
- )
407
-
408
- const graph = buildOrganizationGraph({ organizationModel: model })
409
-
410
- const entityNodes = graph.nodes.filter((n) => n.id === 'entity:crm.deal')
411
- expect(entityNodes).toHaveLength(1)
412
- })
413
-
414
- it('creates only one resource node when the same resource appears in resourceMappings and commandViewData', () => {
415
- const model = resolveOrganizationModel(
416
- defineOrganizationModel({
417
- features: [
418
- {
419
- id: 'ops',
420
- label: 'Ops',
421
- enabled: true,
422
- color: 'violet',
423
- entityIds: [],
424
- surfaceIds: ['ops.view'],
425
- resourceIds: ['wf-shared'],
426
- capabilityIds: []
427
- }
428
- ],
429
- navigation: {
430
- defaultSurfaceId: 'ops.view',
431
- surfaces: [
432
- {
433
- id: 'ops.view',
434
- label: 'Ops View',
435
- path: '/ops/view',
436
- surfaceType: 'graph',
437
- featureId: 'operations',
438
- featureIds: ['ops'],
439
- entityIds: [],
440
- resourceIds: ['wf-shared'],
441
- capabilityIds: []
442
- }
443
- ],
444
- groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
445
- },
446
- resourceMappings: [
447
- {
448
- id: 'wf-shared-model',
449
- label: 'Shared Workflow',
450
- resourceId: 'wf-shared',
451
- resourceType: 'workflow',
452
- featureIds: ['ops'],
453
- entityIds: [],
454
- surfaceIds: ['ops.view'],
455
- capabilityIds: []
456
- }
457
- ]
458
- })
459
- )
460
-
461
- const graph = buildOrganizationGraph({
462
- organizationModel: model,
463
- commandViewData: {
464
- workflows: [
465
- {
466
- resourceId: 'wf-shared',
467
- name: 'Shared Workflow Runtime',
468
- description: 'desc',
469
- version: '1.0.0',
470
- type: 'workflow',
471
- status: 'prod',
472
- domains: ['ops'],
473
- stepCount: 1,
474
- entryPoint: 'start'
475
- }
476
- ],
477
- agents: [],
478
- triggers: [],
479
- integrations: [],
480
- externalResources: [],
481
- humanCheckpoints: [],
482
- edges: []
483
- }
484
- })
485
-
486
- const resourceNodes = graph.nodes.filter((n) => n.id === 'resource:wf-shared')
487
- expect(resourceNodes).toHaveLength(1)
488
- })
489
- })
490
-
491
- describe('commandViewData edge relationships', () => {
492
- it('creates a stub resource node with label === resourceId for edges referencing unknown resources', () => {
493
- const model = resolveOrganizationModel(
494
- defineOrganizationModel({
495
- features: [
496
- {
497
- id: 'ops',
498
- label: 'Ops',
499
- enabled: true,
500
- color: 'violet',
501
- entityIds: [],
502
- surfaceIds: [],
503
- resourceIds: [],
504
- capabilityIds: []
505
- }
506
- ],
507
- navigation: {
508
- defaultSurfaceId: 'ops.view',
509
- surfaces: [
510
- {
511
- id: 'ops.view',
512
- label: 'Ops View',
513
- path: '/ops/view',
514
- surfaceType: 'graph',
515
- featureId: 'operations',
516
- featureIds: [],
517
- entityIds: [],
518
- resourceIds: [],
519
- capabilityIds: []
520
- }
521
- ],
522
- groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
523
- }
524
- })
525
- )
526
-
527
- const graph = buildOrganizationGraph({
528
- organizationModel: model,
529
- commandViewData: {
530
- workflows: [],
531
- agents: [],
532
- triggers: [],
533
- integrations: [],
534
- externalResources: [],
535
- humanCheckpoints: [],
536
- edges: [
537
- {
538
- id: 'edge-unknown',
539
- source: 'unknown-source',
540
- target: 'unknown-target',
541
- relationship: 'triggers'
542
- }
543
- ]
544
- }
545
- })
546
-
547
- const sourceNode = graph.nodes.find((n) => n.id === 'resource:unknown-source')
548
- expect(sourceNode).toBeDefined()
549
- expect(sourceNode?.label).toBe('unknown-source')
550
- expect(sourceNode?.sourceId).toBe('unknown-source')
551
-
552
- const targetNode = graph.nodes.find((n) => n.id === 'resource:unknown-target')
553
- expect(targetNode).toBeDefined()
554
- expect(targetNode?.label).toBe('unknown-target')
555
- expect(targetNode?.sourceId).toBe('unknown-target')
556
- })
557
-
558
- it('normalizes humanCheckpoints type to human_checkpoint on resource nodes', () => {
559
- const model = resolveOrganizationModel(
560
- defineOrganizationModel({
561
- features: [
562
- {
563
- id: 'ops',
564
- label: 'Ops',
565
- enabled: true,
566
- color: 'violet',
567
- entityIds: [],
568
- surfaceIds: [],
569
- resourceIds: [],
570
- capabilityIds: []
571
- }
572
- ],
573
- navigation: {
574
- defaultSurfaceId: 'ops.view',
575
- surfaces: [
576
- {
577
- id: 'ops.view',
578
- label: 'Ops View',
579
- path: '/ops/view',
580
- surfaceType: 'graph',
581
- featureId: 'operations',
582
- featureIds: [],
583
- entityIds: [],
584
- resourceIds: [],
585
- capabilityIds: []
586
- }
587
- ],
588
- groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
589
- }
590
- })
591
- )
592
-
593
- const graph = buildOrganizationGraph({
594
- organizationModel: model,
595
- commandViewData: {
596
- workflows: [],
597
- agents: [],
598
- triggers: [],
599
- integrations: [],
600
- externalResources: [],
601
- humanCheckpoints: [
602
- {
603
- resourceId: 'approval-step',
604
- name: 'Approval Step',
605
- description: 'Human review gate',
606
- version: '1.0.0',
607
- type: 'human',
608
- status: 'prod',
609
- domains: ['ops']
610
- }
611
- ],
612
- edges: []
613
- }
614
- })
615
-
616
- const node = graph.nodes.find((n) => n.id === 'resource:approval-step')
617
- expect(node).toBeDefined()
618
- expect(node?.resourceType).toBe('human_checkpoint')
619
- })
620
-
621
- it('creates a references edge with label and relationshipType for commandViewData edges', () => {
622
- const model = resolveOrganizationModel(
623
- defineOrganizationModel({
624
- features: [
625
- {
626
- id: 'ops',
627
- label: 'Ops',
628
- enabled: true,
629
- color: 'violet',
630
- entityIds: [],
631
- surfaceIds: [],
632
- resourceIds: [],
633
- capabilityIds: []
634
- }
635
- ],
636
- navigation: {
637
- defaultSurfaceId: 'ops.view',
638
- surfaces: [
639
- {
640
- id: 'ops.view',
641
- label: 'Ops View',
642
- path: '/ops/view',
643
- surfaceType: 'graph',
644
- featureId: 'operations',
645
- featureIds: [],
646
- entityIds: [],
647
- resourceIds: [],
648
- capabilityIds: []
649
- }
650
- ],
651
- groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
652
- }
653
- })
654
- )
655
-
656
- const graph = buildOrganizationGraph({
657
- organizationModel: model,
658
- commandViewData: {
659
- workflows: [],
660
- agents: [],
661
- triggers: [],
662
- integrations: [],
663
- externalResources: [],
664
- humanCheckpoints: [],
665
- edges: [
666
- {
667
- id: 'edge-triggers',
668
- source: 'svc-a',
669
- target: 'svc-b',
670
- relationship: 'triggers'
671
- }
672
- ]
673
- }
674
- })
675
-
676
- expect(graph.edges).toEqual(
677
- expect.arrayContaining([
678
- expect.objectContaining({
679
- kind: 'references',
680
- sourceId: 'resource:svc-a',
681
- targetId: 'resource:svc-b',
682
- label: 'triggers',
683
- relationshipType: 'triggers'
684
- })
685
- ])
686
- )
687
- })
688
- })
689
-
690
- it('bridges command view topology into resource nodes and labeled relationship edges', () => {
691
- const model = resolveOrganizationModel(
692
- defineOrganizationModel({
693
- features: [
694
- {
695
- id: 'operations',
696
- label: 'Operations',
697
- description: 'Operational resources, topology, and orchestration visibility',
698
- enabled: true,
699
- color: 'violet',
700
- entityIds: [],
701
- surfaceIds: ['operations.command-view'],
702
- resourceIds: ['workflow-order'],
703
- capabilityIds: ['operations.command-view']
704
- }
705
- ],
706
- navigation: {
707
- defaultSurfaceId: 'operations.command-view',
708
- surfaces: [
709
- {
710
- id: 'operations.command-view',
711
- label: 'Command View',
712
- path: '/operations/command-view',
713
- surfaceType: 'graph',
714
- featureId: 'operations',
715
- featureIds: ['operations'],
716
- entityIds: [],
717
- resourceIds: ['workflow-order'],
718
- capabilityIds: ['operations.command-view']
719
- }
720
- ],
721
- groups: [
722
- {
723
- id: 'primary-operations',
724
- label: 'Operations',
725
- placement: 'primary',
726
- surfaceIds: ['operations.command-view']
727
- }
728
- ]
729
- },
730
- resourceMappings: [
731
- {
732
- id: 'workflow-order-model',
733
- label: 'Order Workflow Model',
734
- resourceId: 'workflow-order',
735
- resourceType: 'workflow',
736
- featureIds: ['operations'],
737
- entityIds: [],
738
- surfaceIds: ['operations.command-view'],
739
- capabilityIds: []
740
- }
741
- ]
742
- })
743
- )
744
-
745
- const graph = buildOrganizationGraph({
746
- organizationModel: model,
747
- commandViewData: {
748
- workflows: [
749
- {
750
- resourceId: 'workflow-order',
751
- name: 'Order Workflow Runtime',
752
- description: 'Runtime workflow surfaced by Command View',
753
- version: '1.0.0',
754
- type: 'workflow',
755
- status: 'prod',
756
- domains: ['operations'],
757
- stepCount: 3,
758
- entryPoint: 'start'
759
- }
760
- ],
761
- agents: [
762
- {
763
- resourceId: 'agent-order',
764
- name: 'Order Agent Runtime',
765
- description: 'Runtime agent surfaced by Command View',
766
- version: '1.0.0',
767
- type: 'agent',
768
- status: 'prod',
769
- domains: ['operations'],
770
- modelProvider: 'openai',
771
- modelId: 'gpt-4.1',
772
- toolCount: 2,
773
- hasKnowledgeMap: true,
774
- hasMemory: false,
775
- sessionCapable: true
776
- }
777
- ],
778
- triggers: [],
779
- integrations: [
780
- {
781
- resourceId: 'integration-stripe',
782
- name: 'Stripe Runtime',
783
- description: 'Runtime integration surfaced by Command View',
784
- version: '1.0.0',
785
- type: 'integration',
786
- status: 'prod',
787
- domains: ['operations'],
788
- provider: 'stripe',
789
- credentialName: 'stripe-prod'
790
- }
791
- ],
792
- externalResources: [],
793
- humanCheckpoints: [
794
- {
795
- resourceId: 'approval-high-value',
796
- name: 'High Value Approval',
797
- description: 'Runtime human checkpoint surfaced by Command View',
798
- version: '1.0.0',
799
- type: 'human',
800
- status: 'prod',
801
- domains: ['operations']
802
- }
803
- ],
804
- edges: [
805
- {
806
- id: 'edge-runtime-triggers',
807
- source: 'agent-order',
808
- target: 'workflow-order',
809
- relationship: 'triggers'
810
- },
811
- {
812
- id: 'edge-runtime-uses',
813
- source: 'workflow-order',
814
- target: 'integration-stripe',
815
- relationship: 'uses'
816
- },
817
- {
818
- id: 'edge-runtime-approval',
819
- source: 'workflow-order',
820
- target: 'approval-high-value',
821
- relationship: 'approval'
822
- }
823
- ]
824
- }
825
- })
826
-
827
- expect(graph.nodes.find((node) => node.id === 'resource:workflow-order')).toMatchObject({
828
- kind: 'resource',
829
- sourceId: 'workflow-order',
830
- resourceType: 'workflow',
831
- label: 'Order Workflow Model'
832
- })
833
-
834
- expect(graph.nodes.find((node) => node.id === 'resource:agent-order')).toMatchObject({
835
- kind: 'resource',
836
- sourceId: 'agent-order',
837
- resourceType: 'agent',
838
- label: 'Order Agent Runtime'
839
- })
840
-
841
- expect(graph.nodes.find((node) => node.id === 'resource:approval-high-value')).toMatchObject({
842
- kind: 'resource',
843
- sourceId: 'approval-high-value',
844
- resourceType: 'human_checkpoint',
845
- label: 'High Value Approval'
846
- })
847
-
848
- expect(graph.edges).toEqual(
849
- expect.arrayContaining([
850
- expect.objectContaining({
851
- kind: 'contains',
852
- sourceId: 'organization-model',
853
- targetId: 'resource:agent-order'
854
- }),
855
- expect.objectContaining({
856
- kind: 'references',
857
- sourceId: 'resource:agent-order',
858
- targetId: 'feature:operations'
859
- }),
860
- expect.objectContaining({
861
- kind: 'references',
862
- sourceId: 'resource:agent-order',
863
- targetId: 'resource:workflow-order',
864
- label: 'triggers',
865
- relationshipType: 'triggers'
866
- }),
867
- expect.objectContaining({
868
- kind: 'references',
869
- sourceId: 'resource:workflow-order',
870
- targetId: 'resource:integration-stripe',
871
- label: 'uses',
872
- relationshipType: 'uses'
873
- }),
874
- expect.objectContaining({
875
- kind: 'references',
876
- sourceId: 'resource:workflow-order',
877
- targetId: 'resource:approval-high-value',
878
- label: 'approval',
879
- relationshipType: 'approval'
880
- }),
881
- expect.objectContaining({
882
- kind: 'maps_to',
883
- sourceId: 'resource:workflow-order',
884
- targetId: 'feature:operations'
885
- }),
886
- expect.objectContaining({
887
- kind: 'maps_to',
888
- sourceId: 'resource:workflow-order',
889
- targetId: 'surface:operations.command-view'
890
- })
891
- ])
892
- )
893
- })
894
- })
1
+ import { describe, expect, it } from 'vitest'
2
+ import { buildOrganizationGraph } from '../graph'
3
+ import { defineOrganizationModel, resolveOrganizationModel } from '../resolve'
4
+
5
+ describe('organization-graph', () => {
6
+ it('derives semantic graph nodes and edges from the organization model', () => {
7
+ const model = resolveOrganizationModel(
8
+ defineOrganizationModel({
9
+ branding: {
10
+ organizationName: 'Acme',
11
+ productName: 'Acme OS',
12
+ shortName: 'Acme'
13
+ }
14
+ })
15
+ )
16
+
17
+ const graph = buildOrganizationGraph({ organizationModel: model })
18
+
19
+ expect(graph.version).toBe(1)
20
+ expect(graph.organizationModelVersion).toBe(1)
21
+
22
+ const feature = graph.nodes.find((node) => node.id === 'feature:operations')
23
+ expect(feature).toMatchObject({
24
+ kind: 'feature',
25
+ sourceId: 'operations',
26
+ label: 'Operations',
27
+ enabled: true,
28
+ featureId: 'operations'
29
+ })
30
+
31
+ const disabledFeature = graph.nodes.find((node) => node.id === 'feature:seo')
32
+ expect(disabledFeature).toMatchObject({
33
+ kind: 'feature',
34
+ sourceId: 'seo',
35
+ enabled: false
36
+ })
37
+
38
+ // Features now carry semantic data directly (no separate domain nodes)
39
+ const crmFeature = graph.nodes.find((node) => node.id === 'feature:crm')
40
+ expect(crmFeature).toMatchObject({
41
+ kind: 'feature',
42
+ sourceId: 'crm',
43
+ label: 'CRM'
44
+ })
45
+
46
+ expect(graph.nodes.find((node) => node.id === 'surface:crm.pipeline')).toMatchObject({
47
+ kind: 'surface',
48
+ sourceId: 'crm.pipeline',
49
+ surfaceType: 'graph'
50
+ })
51
+
52
+ expect(graph.nodes.find((node) => node.id === 'entity:crm.deal')).toMatchObject({
53
+ kind: 'entity',
54
+ sourceId: 'crm.deal',
55
+ label: 'crm.deal'
56
+ })
57
+
58
+ expect(graph.nodes.find((node) => node.id === 'capability:crm.pipeline.manage')).toMatchObject({
59
+ kind: 'capability',
60
+ sourceId: 'crm.pipeline.manage',
61
+ label: 'crm.pipeline.manage'
62
+ })
63
+
64
+ expect(graph.edges).toEqual(
65
+ expect.arrayContaining([
66
+ expect.objectContaining({
67
+ kind: 'contains',
68
+ sourceId: 'organization-model',
69
+ targetId: 'feature:crm'
70
+ }),
71
+ expect.objectContaining({
72
+ kind: 'exposes',
73
+ sourceId: 'feature:crm',
74
+ targetId: 'surface:crm.pipeline'
75
+ }),
76
+ expect.objectContaining({
77
+ kind: 'references',
78
+ sourceId: 'surface:crm.pipeline',
79
+ targetId: 'feature:crm'
80
+ })
81
+ ])
82
+ )
83
+ })
84
+
85
+ describe('feature labels', () => {
86
+ it('uses the feature label directly from the unified features array', () => {
87
+ const model = resolveOrganizationModel(
88
+ defineOrganizationModel({
89
+ branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' }
90
+ })
91
+ )
92
+
93
+ const graph = buildOrganizationGraph({ organizationModel: model })
94
+
95
+ // Verify all default features have their labels from the unified feature definitions
96
+ const expectedLabels: Record<string, string> = {
97
+ crm: 'CRM',
98
+ 'lead-gen': 'Lead Gen',
99
+ projects: 'Projects',
100
+ operations: 'Operations',
101
+ monitoring: 'Monitoring',
102
+ settings: 'Settings',
103
+ seo: 'SEO'
104
+ }
105
+
106
+ for (const [featureId, expectedLabel] of Object.entries(expectedLabels)) {
107
+ const node = graph.nodes.find((n) => n.id === `feature:${featureId}`)
108
+ expect(node, `feature node for '${featureId}' should exist`).toBeDefined()
109
+ expect(node?.label).toBe(expectedLabel)
110
+ }
111
+ })
112
+
113
+ it('uses the overridden label when a feature label is customized', () => {
114
+ const model = resolveOrganizationModel(
115
+ defineOrganizationModel({
116
+ branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' },
117
+ features: [
118
+ {
119
+ id: 'crm',
120
+ label: 'Deals',
121
+ enabled: true,
122
+ entityIds: [],
123
+ surfaceIds: ['crm.pipeline'],
124
+ resourceIds: [],
125
+ capabilityIds: []
126
+ }
127
+ ],
128
+ navigation: {
129
+ defaultSurfaceId: 'crm.pipeline',
130
+ surfaces: [
131
+ {
132
+ id: 'crm.pipeline',
133
+ label: 'Pipeline',
134
+ path: '/crm/pipeline',
135
+ surfaceType: 'graph',
136
+ featureId: 'crm',
137
+ featureIds: ['crm'],
138
+ entityIds: [],
139
+ resourceIds: [],
140
+ capabilityIds: []
141
+ }
142
+ ],
143
+ groups: [{ id: 'g', label: 'CRM', placement: 'primary', surfaceIds: ['crm.pipeline'] }]
144
+ }
145
+ })
146
+ )
147
+
148
+ const graph = buildOrganizationGraph({ organizationModel: model })
149
+
150
+ const node = graph.nodes.find((n) => n.id === 'feature:crm')
151
+ expect(node?.label).toBe('Deals')
152
+ })
153
+ })
154
+
155
+ describe('resource node upsert merging', () => {
156
+ it('keeps resourceMappings label and merges description from commandViewData', () => {
157
+ const model = resolveOrganizationModel(
158
+ defineOrganizationModel({
159
+ features: [
160
+ {
161
+ id: 'operations',
162
+ label: 'Operations',
163
+ enabled: true,
164
+ color: 'violet',
165
+ entityIds: [],
166
+ surfaceIds: ['operations.command-view'],
167
+ resourceIds: ['workflow-order'],
168
+ capabilityIds: []
169
+ }
170
+ ],
171
+ navigation: {
172
+ defaultSurfaceId: 'operations.command-view',
173
+ surfaces: [
174
+ {
175
+ id: 'operations.command-view',
176
+ label: 'Command View',
177
+ path: '/operations/command-view',
178
+ surfaceType: 'graph',
179
+ featureId: 'operations',
180
+ featureIds: ['operations'],
181
+ entityIds: [],
182
+ resourceIds: ['workflow-order'],
183
+ capabilityIds: []
184
+ }
185
+ ],
186
+ groups: [
187
+ {
188
+ id: 'primary-operations',
189
+ label: 'Operations',
190
+ placement: 'primary',
191
+ surfaceIds: ['operations.command-view']
192
+ }
193
+ ]
194
+ },
195
+ resourceMappings: [
196
+ {
197
+ id: 'workflow-order-model',
198
+ label: 'Order Workflow',
199
+ resourceId: 'workflow-order',
200
+ resourceType: 'workflow',
201
+ featureIds: ['operations'],
202
+ entityIds: [],
203
+ surfaceIds: ['operations.command-view'],
204
+ capabilityIds: []
205
+ }
206
+ ]
207
+ })
208
+ )
209
+
210
+ const graph = buildOrganizationGraph({
211
+ organizationModel: model,
212
+ commandViewData: {
213
+ workflows: [
214
+ {
215
+ resourceId: 'workflow-order',
216
+ name: 'Order Workflow Runtime',
217
+ description: 'Runtime description from commandViewData',
218
+ version: '1.0.0',
219
+ type: 'workflow',
220
+ status: 'prod',
221
+ domains: ['operations'],
222
+ stepCount: 2,
223
+ entryPoint: 'start'
224
+ }
225
+ ],
226
+ agents: [],
227
+ triggers: [],
228
+ integrations: [],
229
+ externalResources: [],
230
+ humanCheckpoints: [],
231
+ edges: []
232
+ }
233
+ })
234
+
235
+ const resourceNodes = graph.nodes.filter((n) => n.id === 'resource:workflow-order')
236
+ expect(resourceNodes).toHaveLength(1)
237
+
238
+ const node = resourceNodes[0]
239
+ expect(node.label).toBe('Order Workflow')
240
+ expect(node.description).toBe('Runtime description from commandViewData')
241
+ })
242
+
243
+ it('preserves existing non-default label even when commandViewData provides a different name', () => {
244
+ const model = resolveOrganizationModel(
245
+ defineOrganizationModel({
246
+ features: [
247
+ {
248
+ id: 'ops',
249
+ label: 'Ops',
250
+ enabled: true,
251
+ color: 'blue',
252
+ entityIds: [],
253
+ surfaceIds: ['ops.view'],
254
+ resourceIds: ['res-a'],
255
+ capabilityIds: []
256
+ }
257
+ ],
258
+ navigation: {
259
+ defaultSurfaceId: 'ops.view',
260
+ surfaces: [
261
+ {
262
+ id: 'ops.view',
263
+ label: 'Ops View',
264
+ path: '/ops/view',
265
+ surfaceType: 'graph',
266
+ featureId: 'operations',
267
+ featureIds: ['ops'],
268
+ entityIds: [],
269
+ resourceIds: ['res-a'],
270
+ capabilityIds: []
271
+ }
272
+ ],
273
+ groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
274
+ },
275
+ resourceMappings: [
276
+ {
277
+ id: 'res-a-model',
278
+ label: 'My Custom Label',
279
+ resourceId: 'res-a',
280
+ resourceType: 'workflow',
281
+ featureIds: ['ops'],
282
+ entityIds: [],
283
+ surfaceIds: ['ops.view'],
284
+ capabilityIds: []
285
+ }
286
+ ]
287
+ })
288
+ )
289
+
290
+ const graph = buildOrganizationGraph({
291
+ organizationModel: model,
292
+ commandViewData: {
293
+ workflows: [
294
+ {
295
+ resourceId: 'res-a',
296
+ name: 'Runtime Name Should Not Override',
297
+ description: 'desc',
298
+ version: '1.0.0',
299
+ type: 'workflow',
300
+ status: 'prod',
301
+ domains: ['ops'],
302
+ stepCount: 1,
303
+ entryPoint: 'start'
304
+ }
305
+ ],
306
+ agents: [],
307
+ triggers: [],
308
+ integrations: [],
309
+ externalResources: [],
310
+ humanCheckpoints: [],
311
+ edges: []
312
+ }
313
+ })
314
+
315
+ const node = graph.nodes.find((n) => n.id === 'resource:res-a')
316
+ expect(node?.label).toBe('My Custom Label')
317
+ })
318
+ })
319
+
320
+ describe('de-duplication of graph elements', () => {
321
+ it('creates only one feature node when multiple surfaces reference the same feature', () => {
322
+ const model = resolveOrganizationModel(
323
+ defineOrganizationModel({
324
+ features: [
325
+ {
326
+ id: 'crm',
327
+ label: 'CRM',
328
+ enabled: true,
329
+ color: 'blue',
330
+ entityIds: [],
331
+ surfaceIds: ['crm.pipeline', 'crm.accounts'],
332
+ resourceIds: [],
333
+ capabilityIds: []
334
+ }
335
+ ],
336
+ navigation: {
337
+ defaultSurfaceId: 'crm.pipeline',
338
+ surfaces: [
339
+ {
340
+ id: 'crm.pipeline',
341
+ label: 'Pipeline',
342
+ path: '/crm/pipeline',
343
+ surfaceType: 'graph',
344
+ featureId: 'crm',
345
+ featureIds: ['crm'],
346
+ entityIds: [],
347
+ resourceIds: [],
348
+ capabilityIds: []
349
+ },
350
+ {
351
+ id: 'crm.accounts',
352
+ label: 'Accounts',
353
+ path: '/crm/accounts',
354
+ surfaceType: 'list',
355
+ featureId: 'crm',
356
+ featureIds: ['crm'],
357
+ entityIds: [],
358
+ resourceIds: [],
359
+ capabilityIds: []
360
+ }
361
+ ],
362
+ groups: [{ id: 'g', label: 'CRM', placement: 'primary', surfaceIds: ['crm.pipeline', 'crm.accounts'] }]
363
+ }
364
+ })
365
+ )
366
+
367
+ const graph = buildOrganizationGraph({ organizationModel: model })
368
+
369
+ const featureNodes = graph.nodes.filter((n) => n.id === 'feature:crm')
370
+ expect(featureNodes).toHaveLength(1)
371
+ })
372
+
373
+ it('creates only one entity node when the same entity appears in both a feature and a surface', () => {
374
+ const model = resolveOrganizationModel(
375
+ defineOrganizationModel({
376
+ features: [
377
+ {
378
+ id: 'crm',
379
+ label: 'CRM',
380
+ enabled: true,
381
+ color: 'blue',
382
+ entityIds: ['crm.deal'],
383
+ surfaceIds: ['crm.pipeline'],
384
+ resourceIds: [],
385
+ capabilityIds: []
386
+ }
387
+ ],
388
+ navigation: {
389
+ defaultSurfaceId: 'crm.pipeline',
390
+ surfaces: [
391
+ {
392
+ id: 'crm.pipeline',
393
+ label: 'Pipeline',
394
+ path: '/crm/pipeline',
395
+ surfaceType: 'graph',
396
+ featureId: 'crm',
397
+ featureIds: ['crm'],
398
+ entityIds: ['crm.deal'],
399
+ resourceIds: [],
400
+ capabilityIds: []
401
+ }
402
+ ],
403
+ groups: [{ id: 'g', label: 'CRM', placement: 'primary', surfaceIds: ['crm.pipeline'] }]
404
+ }
405
+ })
406
+ )
407
+
408
+ const graph = buildOrganizationGraph({ organizationModel: model })
409
+
410
+ const entityNodes = graph.nodes.filter((n) => n.id === 'entity:crm.deal')
411
+ expect(entityNodes).toHaveLength(1)
412
+ })
413
+
414
+ it('creates only one resource node when the same resource appears in resourceMappings and commandViewData', () => {
415
+ const model = resolveOrganizationModel(
416
+ defineOrganizationModel({
417
+ features: [
418
+ {
419
+ id: 'ops',
420
+ label: 'Ops',
421
+ enabled: true,
422
+ color: 'violet',
423
+ entityIds: [],
424
+ surfaceIds: ['ops.view'],
425
+ resourceIds: ['wf-shared'],
426
+ capabilityIds: []
427
+ }
428
+ ],
429
+ navigation: {
430
+ defaultSurfaceId: 'ops.view',
431
+ surfaces: [
432
+ {
433
+ id: 'ops.view',
434
+ label: 'Ops View',
435
+ path: '/ops/view',
436
+ surfaceType: 'graph',
437
+ featureId: 'operations',
438
+ featureIds: ['ops'],
439
+ entityIds: [],
440
+ resourceIds: ['wf-shared'],
441
+ capabilityIds: []
442
+ }
443
+ ],
444
+ groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
445
+ },
446
+ resourceMappings: [
447
+ {
448
+ id: 'wf-shared-model',
449
+ label: 'Shared Workflow',
450
+ resourceId: 'wf-shared',
451
+ resourceType: 'workflow',
452
+ featureIds: ['ops'],
453
+ entityIds: [],
454
+ surfaceIds: ['ops.view'],
455
+ capabilityIds: []
456
+ }
457
+ ]
458
+ })
459
+ )
460
+
461
+ const graph = buildOrganizationGraph({
462
+ organizationModel: model,
463
+ commandViewData: {
464
+ workflows: [
465
+ {
466
+ resourceId: 'wf-shared',
467
+ name: 'Shared Workflow Runtime',
468
+ description: 'desc',
469
+ version: '1.0.0',
470
+ type: 'workflow',
471
+ status: 'prod',
472
+ domains: ['ops'],
473
+ stepCount: 1,
474
+ entryPoint: 'start'
475
+ }
476
+ ],
477
+ agents: [],
478
+ triggers: [],
479
+ integrations: [],
480
+ externalResources: [],
481
+ humanCheckpoints: [],
482
+ edges: []
483
+ }
484
+ })
485
+
486
+ const resourceNodes = graph.nodes.filter((n) => n.id === 'resource:wf-shared')
487
+ expect(resourceNodes).toHaveLength(1)
488
+ })
489
+ })
490
+
491
+ describe('commandViewData edge relationships', () => {
492
+ it('creates a stub resource node with label === resourceId for edges referencing unknown resources', () => {
493
+ const model = resolveOrganizationModel(
494
+ defineOrganizationModel({
495
+ features: [
496
+ {
497
+ id: 'ops',
498
+ label: 'Ops',
499
+ enabled: true,
500
+ color: 'violet',
501
+ entityIds: [],
502
+ surfaceIds: [],
503
+ resourceIds: [],
504
+ capabilityIds: []
505
+ }
506
+ ],
507
+ navigation: {
508
+ defaultSurfaceId: 'ops.view',
509
+ surfaces: [
510
+ {
511
+ id: 'ops.view',
512
+ label: 'Ops View',
513
+ path: '/ops/view',
514
+ surfaceType: 'graph',
515
+ featureId: 'operations',
516
+ featureIds: [],
517
+ entityIds: [],
518
+ resourceIds: [],
519
+ capabilityIds: []
520
+ }
521
+ ],
522
+ groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
523
+ }
524
+ })
525
+ )
526
+
527
+ const graph = buildOrganizationGraph({
528
+ organizationModel: model,
529
+ commandViewData: {
530
+ workflows: [],
531
+ agents: [],
532
+ triggers: [],
533
+ integrations: [],
534
+ externalResources: [],
535
+ humanCheckpoints: [],
536
+ edges: [
537
+ {
538
+ id: 'edge-unknown',
539
+ source: 'unknown-source',
540
+ target: 'unknown-target',
541
+ relationship: 'triggers'
542
+ }
543
+ ]
544
+ }
545
+ })
546
+
547
+ const sourceNode = graph.nodes.find((n) => n.id === 'resource:unknown-source')
548
+ expect(sourceNode).toBeDefined()
549
+ expect(sourceNode?.label).toBe('unknown-source')
550
+ expect(sourceNode?.sourceId).toBe('unknown-source')
551
+
552
+ const targetNode = graph.nodes.find((n) => n.id === 'resource:unknown-target')
553
+ expect(targetNode).toBeDefined()
554
+ expect(targetNode?.label).toBe('unknown-target')
555
+ expect(targetNode?.sourceId).toBe('unknown-target')
556
+ })
557
+
558
+ it('normalizes humanCheckpoints type to human_checkpoint on resource nodes', () => {
559
+ const model = resolveOrganizationModel(
560
+ defineOrganizationModel({
561
+ features: [
562
+ {
563
+ id: 'ops',
564
+ label: 'Ops',
565
+ enabled: true,
566
+ color: 'violet',
567
+ entityIds: [],
568
+ surfaceIds: [],
569
+ resourceIds: [],
570
+ capabilityIds: []
571
+ }
572
+ ],
573
+ navigation: {
574
+ defaultSurfaceId: 'ops.view',
575
+ surfaces: [
576
+ {
577
+ id: 'ops.view',
578
+ label: 'Ops View',
579
+ path: '/ops/view',
580
+ surfaceType: 'graph',
581
+ featureId: 'operations',
582
+ featureIds: [],
583
+ entityIds: [],
584
+ resourceIds: [],
585
+ capabilityIds: []
586
+ }
587
+ ],
588
+ groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
589
+ }
590
+ })
591
+ )
592
+
593
+ const graph = buildOrganizationGraph({
594
+ organizationModel: model,
595
+ commandViewData: {
596
+ workflows: [],
597
+ agents: [],
598
+ triggers: [],
599
+ integrations: [],
600
+ externalResources: [],
601
+ humanCheckpoints: [
602
+ {
603
+ resourceId: 'approval-step',
604
+ name: 'Approval Step',
605
+ description: 'Human review gate',
606
+ version: '1.0.0',
607
+ type: 'human',
608
+ status: 'prod',
609
+ domains: ['ops']
610
+ }
611
+ ],
612
+ edges: []
613
+ }
614
+ })
615
+
616
+ const node = graph.nodes.find((n) => n.id === 'resource:approval-step')
617
+ expect(node).toBeDefined()
618
+ expect(node?.resourceType).toBe('human_checkpoint')
619
+ })
620
+
621
+ it('creates a references edge with label and relationshipType for commandViewData edges', () => {
622
+ const model = resolveOrganizationModel(
623
+ defineOrganizationModel({
624
+ features: [
625
+ {
626
+ id: 'ops',
627
+ label: 'Ops',
628
+ enabled: true,
629
+ color: 'violet',
630
+ entityIds: [],
631
+ surfaceIds: [],
632
+ resourceIds: [],
633
+ capabilityIds: []
634
+ }
635
+ ],
636
+ navigation: {
637
+ defaultSurfaceId: 'ops.view',
638
+ surfaces: [
639
+ {
640
+ id: 'ops.view',
641
+ label: 'Ops View',
642
+ path: '/ops/view',
643
+ surfaceType: 'graph',
644
+ featureId: 'operations',
645
+ featureIds: [],
646
+ entityIds: [],
647
+ resourceIds: [],
648
+ capabilityIds: []
649
+ }
650
+ ],
651
+ groups: [{ id: 'g', label: 'Ops', placement: 'primary', surfaceIds: ['ops.view'] }]
652
+ }
653
+ })
654
+ )
655
+
656
+ const graph = buildOrganizationGraph({
657
+ organizationModel: model,
658
+ commandViewData: {
659
+ workflows: [],
660
+ agents: [],
661
+ triggers: [],
662
+ integrations: [],
663
+ externalResources: [],
664
+ humanCheckpoints: [],
665
+ edges: [
666
+ {
667
+ id: 'edge-triggers',
668
+ source: 'svc-a',
669
+ target: 'svc-b',
670
+ relationship: 'triggers'
671
+ }
672
+ ]
673
+ }
674
+ })
675
+
676
+ expect(graph.edges).toEqual(
677
+ expect.arrayContaining([
678
+ expect.objectContaining({
679
+ kind: 'references',
680
+ sourceId: 'resource:svc-a',
681
+ targetId: 'resource:svc-b',
682
+ label: 'triggers',
683
+ relationshipType: 'triggers'
684
+ })
685
+ ])
686
+ )
687
+ })
688
+ })
689
+
690
+ it('bridges command view topology into resource nodes and labeled relationship edges', () => {
691
+ const model = resolveOrganizationModel(
692
+ defineOrganizationModel({
693
+ features: [
694
+ {
695
+ id: 'operations',
696
+ label: 'Operations',
697
+ description: 'Operational resources, topology, and orchestration visibility',
698
+ enabled: true,
699
+ color: 'violet',
700
+ entityIds: [],
701
+ surfaceIds: ['operations.command-view'],
702
+ resourceIds: ['workflow-order'],
703
+ capabilityIds: ['operations.command-view']
704
+ }
705
+ ],
706
+ navigation: {
707
+ defaultSurfaceId: 'operations.command-view',
708
+ surfaces: [
709
+ {
710
+ id: 'operations.command-view',
711
+ label: 'Command View',
712
+ path: '/operations/command-view',
713
+ surfaceType: 'graph',
714
+ featureId: 'operations',
715
+ featureIds: ['operations'],
716
+ entityIds: [],
717
+ resourceIds: ['workflow-order'],
718
+ capabilityIds: ['operations.command-view']
719
+ }
720
+ ],
721
+ groups: [
722
+ {
723
+ id: 'primary-operations',
724
+ label: 'Operations',
725
+ placement: 'primary',
726
+ surfaceIds: ['operations.command-view']
727
+ }
728
+ ]
729
+ },
730
+ resourceMappings: [
731
+ {
732
+ id: 'workflow-order-model',
733
+ label: 'Order Workflow Model',
734
+ resourceId: 'workflow-order',
735
+ resourceType: 'workflow',
736
+ featureIds: ['operations'],
737
+ entityIds: [],
738
+ surfaceIds: ['operations.command-view'],
739
+ capabilityIds: []
740
+ }
741
+ ]
742
+ })
743
+ )
744
+
745
+ const graph = buildOrganizationGraph({
746
+ organizationModel: model,
747
+ commandViewData: {
748
+ workflows: [
749
+ {
750
+ resourceId: 'workflow-order',
751
+ name: 'Order Workflow Runtime',
752
+ description: 'Runtime workflow surfaced by Command View',
753
+ version: '1.0.0',
754
+ type: 'workflow',
755
+ status: 'prod',
756
+ domains: ['operations'],
757
+ stepCount: 3,
758
+ entryPoint: 'start'
759
+ }
760
+ ],
761
+ agents: [
762
+ {
763
+ resourceId: 'agent-order',
764
+ name: 'Order Agent Runtime',
765
+ description: 'Runtime agent surfaced by Command View',
766
+ version: '1.0.0',
767
+ type: 'agent',
768
+ status: 'prod',
769
+ domains: ['operations'],
770
+ modelProvider: 'openai',
771
+ modelId: 'gpt-4.1',
772
+ toolCount: 2,
773
+ hasKnowledgeMap: true,
774
+ hasMemory: false,
775
+ sessionCapable: true
776
+ }
777
+ ],
778
+ triggers: [],
779
+ integrations: [
780
+ {
781
+ resourceId: 'integration-stripe',
782
+ name: 'Stripe Runtime',
783
+ description: 'Runtime integration surfaced by Command View',
784
+ version: '1.0.0',
785
+ type: 'integration',
786
+ status: 'prod',
787
+ domains: ['operations'],
788
+ provider: 'stripe',
789
+ credentialName: 'stripe-prod'
790
+ }
791
+ ],
792
+ externalResources: [],
793
+ humanCheckpoints: [
794
+ {
795
+ resourceId: 'approval-high-value',
796
+ name: 'High Value Approval',
797
+ description: 'Runtime human checkpoint surfaced by Command View',
798
+ version: '1.0.0',
799
+ type: 'human',
800
+ status: 'prod',
801
+ domains: ['operations']
802
+ }
803
+ ],
804
+ edges: [
805
+ {
806
+ id: 'edge-runtime-triggers',
807
+ source: 'agent-order',
808
+ target: 'workflow-order',
809
+ relationship: 'triggers'
810
+ },
811
+ {
812
+ id: 'edge-runtime-uses',
813
+ source: 'workflow-order',
814
+ target: 'integration-stripe',
815
+ relationship: 'uses'
816
+ },
817
+ {
818
+ id: 'edge-runtime-approval',
819
+ source: 'workflow-order',
820
+ target: 'approval-high-value',
821
+ relationship: 'approval'
822
+ }
823
+ ]
824
+ }
825
+ })
826
+
827
+ expect(graph.nodes.find((node) => node.id === 'resource:workflow-order')).toMatchObject({
828
+ kind: 'resource',
829
+ sourceId: 'workflow-order',
830
+ resourceType: 'workflow',
831
+ label: 'Order Workflow Model'
832
+ })
833
+
834
+ expect(graph.nodes.find((node) => node.id === 'resource:agent-order')).toMatchObject({
835
+ kind: 'resource',
836
+ sourceId: 'agent-order',
837
+ resourceType: 'agent',
838
+ label: 'Order Agent Runtime'
839
+ })
840
+
841
+ expect(graph.nodes.find((node) => node.id === 'resource:approval-high-value')).toMatchObject({
842
+ kind: 'resource',
843
+ sourceId: 'approval-high-value',
844
+ resourceType: 'human_checkpoint',
845
+ label: 'High Value Approval'
846
+ })
847
+
848
+ expect(graph.edges).toEqual(
849
+ expect.arrayContaining([
850
+ expect.objectContaining({
851
+ kind: 'contains',
852
+ sourceId: 'organization-model',
853
+ targetId: 'resource:agent-order'
854
+ }),
855
+ expect.objectContaining({
856
+ kind: 'references',
857
+ sourceId: 'resource:agent-order',
858
+ targetId: 'feature:operations'
859
+ }),
860
+ expect.objectContaining({
861
+ kind: 'references',
862
+ sourceId: 'resource:agent-order',
863
+ targetId: 'resource:workflow-order',
864
+ label: 'triggers',
865
+ relationshipType: 'triggers'
866
+ }),
867
+ expect.objectContaining({
868
+ kind: 'references',
869
+ sourceId: 'resource:workflow-order',
870
+ targetId: 'resource:integration-stripe',
871
+ label: 'uses',
872
+ relationshipType: 'uses'
873
+ }),
874
+ expect.objectContaining({
875
+ kind: 'references',
876
+ sourceId: 'resource:workflow-order',
877
+ targetId: 'resource:approval-high-value',
878
+ label: 'approval',
879
+ relationshipType: 'approval'
880
+ }),
881
+ expect.objectContaining({
882
+ kind: 'maps_to',
883
+ sourceId: 'resource:workflow-order',
884
+ targetId: 'feature:operations'
885
+ }),
886
+ expect.objectContaining({
887
+ kind: 'maps_to',
888
+ sourceId: 'resource:workflow-order',
889
+ targetId: 'surface:operations.command-view'
890
+ })
891
+ ])
892
+ )
893
+ })
894
+ })