@elevasis/core 0.23.0 → 0.24.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 (241) hide show
  1. package/dist/index.d.ts +1326 -552
  2. package/dist/index.js +869 -154
  3. package/dist/knowledge/index.d.ts +487 -209
  4. package/dist/knowledge/index.js +104 -1
  5. package/dist/organization-model/index.d.ts +1326 -552
  6. package/dist/organization-model/index.js +869 -154
  7. package/dist/test-utils/index.d.ts +357 -72
  8. package/dist/test-utils/index.js +795 -142
  9. package/package.json +5 -5
  10. package/src/README.md +14 -14
  11. package/src/__tests__/publish.test.ts +24 -24
  12. package/src/__tests__/template-core-compatibility.test.ts +9 -12
  13. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +2102 -2096
  14. package/src/_gen/__tests__/scaffold-contracts.test.ts +30 -30
  15. package/src/auth/multi-tenancy/credentials/__tests__/encryption.test.ts +217 -217
  16. package/src/auth/multi-tenancy/credentials/server/encryption.ts +69 -69
  17. package/src/auth/multi-tenancy/credentials/server/kek-loader.ts +37 -37
  18. package/src/auth/multi-tenancy/index.ts +26 -26
  19. package/src/auth/multi-tenancy/invitations/api-schemas.ts +104 -104
  20. package/src/auth/multi-tenancy/memberships/api-schemas.ts +143 -143
  21. package/src/auth/multi-tenancy/memberships/index.ts +26 -26
  22. package/src/auth/multi-tenancy/memberships/membership.ts +130 -130
  23. package/src/auth/multi-tenancy/organizations/__tests__/api-schemas.test.ts +194 -194
  24. package/src/auth/multi-tenancy/organizations/api-schemas.ts +136 -136
  25. package/src/auth/multi-tenancy/permissions.test.ts +42 -42
  26. package/src/auth/multi-tenancy/permissions.ts +123 -123
  27. package/src/auth/multi-tenancy/role-management/api-schemas.ts +78 -78
  28. package/src/auth/multi-tenancy/role-management/index.ts +16 -16
  29. package/src/auth/multi-tenancy/theme-presets.ts +45 -45
  30. package/src/auth/multi-tenancy/types.ts +57 -57
  31. package/src/auth/multi-tenancy/users/api-schemas.ts +165 -165
  32. package/src/business/README.md +2 -2
  33. package/src/business/acquisition/activity-events.test.ts +250 -250
  34. package/src/business/acquisition/activity-events.ts +93 -93
  35. package/src/business/acquisition/api-schemas.test.ts +1883 -1843
  36. package/src/business/acquisition/api-schemas.ts +1492 -1497
  37. package/src/business/acquisition/build-templates.test.ts +240 -240
  38. package/src/business/acquisition/build-templates.ts +98 -98
  39. package/src/business/acquisition/crm-next-action.test.ts +262 -262
  40. package/src/business/acquisition/crm-next-action.ts +220 -220
  41. package/src/business/acquisition/crm-priority.test.ts +216 -216
  42. package/src/business/acquisition/crm-priority.ts +349 -349
  43. package/src/business/acquisition/crm-state-actions.test.ts +153 -153
  44. package/src/business/acquisition/deal-ownership.test.ts +351 -351
  45. package/src/business/acquisition/deal-ownership.ts +120 -120
  46. package/src/business/acquisition/derive-actions.test.ts +129 -104
  47. package/src/business/acquisition/derive-actions.ts +74 -84
  48. package/src/business/acquisition/index.ts +171 -170
  49. package/src/business/acquisition/ontology-validation.ts +309 -0
  50. package/src/business/acquisition/stateful.ts +30 -30
  51. package/src/business/acquisition/types.ts +396 -396
  52. package/src/business/clients/api-schemas.test.ts +115 -115
  53. package/src/business/clients/api-schemas.ts +158 -158
  54. package/src/business/clients/index.ts +1 -1
  55. package/src/business/crm/api-schemas.ts +40 -40
  56. package/src/business/crm/index.ts +1 -1
  57. package/src/business/deals/api-schemas.ts +87 -87
  58. package/src/business/deals/index.ts +1 -1
  59. package/src/business/index.ts +5 -5
  60. package/src/business/projects/types.ts +144 -144
  61. package/src/commands/queue/types/task.ts +15 -15
  62. package/src/execution/core/runner-types.ts +61 -61
  63. package/src/execution/core/sse-executions.ts +7 -7
  64. package/src/execution/engine/__tests__/fixtures/test-agents.ts +10 -10
  65. package/src/execution/engine/agent/core/__tests__/agent.test.ts +16 -16
  66. package/src/execution/engine/agent/core/__tests__/error-passthrough.test.ts +4 -4
  67. package/src/execution/engine/agent/core/types.ts +25 -25
  68. package/src/execution/engine/agent/index.ts +6 -6
  69. package/src/execution/engine/agent/reasoning/__tests__/request-builder.test.ts +24 -24
  70. package/src/execution/engine/index.ts +443 -443
  71. package/src/execution/engine/tools/integration/server/adapters/apify/__tests__/apify-run-actor.integration.test.ts +298 -298
  72. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.test.ts +55 -55
  73. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.ts +107 -107
  74. package/src/execution/engine/tools/integration/server/adapters/apollo/apollo-adapter.test.ts +48 -48
  75. package/src/execution/engine/tools/integration/server/adapters/apollo/apollo-adapter.ts +99 -99
  76. package/src/execution/engine/tools/integration/server/adapters/apollo/index.ts +1 -1
  77. package/src/execution/engine/tools/integration/server/adapters/attio/__tests__/attio-crud.integration.test.ts +363 -363
  78. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/get-record/index.test.ts +162 -162
  79. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-records/index.test.ts +316 -316
  80. package/src/execution/engine/tools/integration/server/adapters/clickup/clickup-adapter.test.ts +18 -18
  81. package/src/execution/engine/tools/integration/server/adapters/clickup/clickup-adapter.ts +194 -194
  82. package/src/execution/engine/tools/integration/server/adapters/clickup/index.ts +7 -7
  83. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-adapter.ts +204 -204
  84. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-tools.ts +105 -105
  85. package/src/execution/engine/tools/integration/server/adapters/google-calendar/google-calendar-adapter.ts +428 -428
  86. package/src/execution/engine/tools/integration/server/adapters/google-calendar/index.ts +2 -2
  87. package/src/execution/engine/tools/integration/server/adapters/google-sheets/__tests__/google-sheets.integration.test.ts +261 -261
  88. package/src/execution/engine/tools/integration/server/adapters/instantly/instantly-tools.ts +1474 -1474
  89. package/src/execution/engine/tools/integration/server/adapters/millionverifier/millionverifier-tools.ts +103 -103
  90. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.test.ts +88 -88
  91. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.ts +141 -141
  92. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/utils/types.ts +76 -76
  93. package/src/execution/engine/tools/integration/server/adapters/signature-api/signature-api-tools.ts +182 -182
  94. package/src/execution/engine/tools/integration/server/adapters/stripe/stripe-tools.ts +310 -310
  95. package/src/execution/engine/tools/integration/service.test.ts +239 -239
  96. package/src/execution/engine/tools/integration/service.ts +172 -172
  97. package/src/execution/engine/tools/integration/tool.ts +255 -255
  98. package/src/execution/engine/tools/lead-service-types.ts +1005 -1005
  99. package/src/execution/engine/tools/messages.ts +43 -43
  100. package/src/execution/engine/tools/platform/acquisition/company-tools.ts +7 -7
  101. package/src/execution/engine/tools/platform/acquisition/contact-tools.ts +6 -6
  102. package/src/execution/engine/tools/platform/acquisition/list-tools.ts +6 -6
  103. package/src/execution/engine/tools/platform/acquisition/types.ts +280 -280
  104. package/src/execution/engine/tools/platform/email/types.ts +97 -97
  105. package/src/execution/engine/tools/registry.ts +704 -704
  106. package/src/execution/engine/tools/tool-maps.ts +831 -831
  107. package/src/execution/engine/tools/types.ts +234 -234
  108. package/src/execution/engine/workflow/types.ts +202 -202
  109. package/src/execution/external/__tests__/api-schemas.test.ts +127 -127
  110. package/src/execution/external/api-schemas.ts +40 -40
  111. package/src/execution/external/index.ts +1 -1
  112. package/src/index.ts +18 -18
  113. package/src/integrations/credentials/__tests__/api-schemas.test.ts +420 -420
  114. package/src/integrations/credentials/api-schemas.ts +146 -146
  115. package/src/integrations/credentials/schemas.ts +200 -200
  116. package/src/integrations/oauth/__tests__/provider-registry.test.ts +7 -7
  117. package/src/integrations/oauth/provider-registry.ts +74 -74
  118. package/src/integrations/oauth/server/credentials.ts +43 -43
  119. package/src/integrations/webhook-endpoints/__tests__/api-schemas.test.ts +327 -327
  120. package/src/integrations/webhook-endpoints/api-schemas.ts +103 -103
  121. package/src/integrations/webhook-endpoints/types.ts +58 -58
  122. package/src/knowledge/README.md +32 -32
  123. package/src/knowledge/__tests__/queries.test.ts +626 -535
  124. package/src/knowledge/format.ts +99 -99
  125. package/src/knowledge/index.ts +5 -5
  126. package/src/knowledge/published.ts +5 -5
  127. package/src/knowledge/queries.ts +269 -218
  128. package/src/operations/activities/api-schemas.ts +80 -80
  129. package/src/operations/activities/types.ts +64 -64
  130. package/src/organization-model/README.md +149 -149
  131. package/src/organization-model/__tests__/content-kinds-registry.test.ts +210 -210
  132. package/src/organization-model/__tests__/defaults.test.ts +168 -168
  133. package/src/organization-model/__tests__/domains/actions.test.ts +78 -56
  134. package/src/organization-model/__tests__/domains/customers.test.ts +299 -299
  135. package/src/organization-model/__tests__/domains/entities.test.ts +56 -56
  136. package/src/organization-model/__tests__/domains/goals.test.ts +493 -493
  137. package/src/organization-model/__tests__/domains/identity.test.ts +280 -280
  138. package/src/organization-model/__tests__/domains/navigation.test.ts +268 -268
  139. package/src/organization-model/__tests__/domains/offerings.test.ts +414 -414
  140. package/src/organization-model/__tests__/domains/policies.test.ts +323 -323
  141. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +293 -293
  142. package/src/organization-model/__tests__/domains/resources.test.ts +382 -283
  143. package/src/organization-model/__tests__/domains/roles.test.ts +463 -463
  144. package/src/organization-model/__tests__/domains/statuses.test.ts +246 -246
  145. package/src/organization-model/__tests__/domains/systems.test.ts +209 -209
  146. package/src/organization-model/__tests__/flatten-additive-merge.test.ts +362 -361
  147. package/src/organization-model/__tests__/foundation.test.ts +77 -77
  148. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -144
  149. package/src/organization-model/__tests__/graph.test.ts +1246 -887
  150. package/src/organization-model/__tests__/icons.test.ts +10 -1
  151. package/src/organization-model/__tests__/knowledge.test.ts +251 -15
  152. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -438
  153. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -591
  154. package/src/organization-model/__tests__/prospecting-ssot.test.ts +103 -103
  155. package/src/organization-model/__tests__/recursive-system-schema.test.ts +535 -506
  156. package/src/organization-model/__tests__/resolve.test.ts +274 -164
  157. package/src/organization-model/__tests__/schema.test.ts +834 -301
  158. package/src/organization-model/__tests__/surface-projection.test.ts +284 -284
  159. package/src/organization-model/catalogs/lead-gen.ts +144 -144
  160. package/src/organization-model/content-kinds/config.ts +36 -36
  161. package/src/organization-model/content-kinds/index.ts +76 -72
  162. package/src/organization-model/content-kinds/pipeline.ts +68 -68
  163. package/src/organization-model/content-kinds/registry.ts +44 -44
  164. package/src/organization-model/content-kinds/status.ts +71 -71
  165. package/src/organization-model/content-kinds/template.ts +83 -83
  166. package/src/organization-model/content-kinds/types.ts +117 -117
  167. package/src/organization-model/contracts.ts +27 -27
  168. package/src/organization-model/defaults.ts +40 -50
  169. package/src/organization-model/domains/actions.ts +333 -239
  170. package/src/organization-model/domains/customers.ts +78 -78
  171. package/src/organization-model/domains/entities.ts +144 -144
  172. package/src/organization-model/domains/goals.ts +83 -83
  173. package/src/organization-model/domains/knowledge.ts +117 -101
  174. package/src/organization-model/domains/navigation.ts +139 -139
  175. package/src/organization-model/domains/offerings.ts +71 -71
  176. package/src/organization-model/domains/policies.ts +102 -102
  177. package/src/organization-model/domains/projects.ts +14 -14
  178. package/src/organization-model/domains/prospecting.ts +395 -395
  179. package/src/organization-model/domains/resources.ts +167 -132
  180. package/src/organization-model/domains/roles.ts +96 -96
  181. package/src/organization-model/domains/sales.test.ts +218 -218
  182. package/src/organization-model/domains/sales.ts +380 -380
  183. package/src/organization-model/domains/shared.ts +63 -63
  184. package/src/organization-model/domains/statuses.ts +339 -339
  185. package/src/organization-model/domains/systems.ts +217 -172
  186. package/src/organization-model/foundation.ts +75 -75
  187. package/src/organization-model/graph/build.ts +1016 -888
  188. package/src/organization-model/graph/index.ts +4 -4
  189. package/src/organization-model/graph/link.ts +10 -10
  190. package/src/organization-model/graph/schema.ts +76 -70
  191. package/src/organization-model/graph/types.ts +73 -67
  192. package/src/organization-model/helpers.ts +289 -241
  193. package/src/organization-model/icons.ts +78 -66
  194. package/src/organization-model/index.ts +130 -128
  195. package/src/organization-model/migration-helpers.ts +247 -244
  196. package/src/organization-model/ontology.ts +661 -0
  197. package/src/organization-model/organization-graph.mdx +110 -90
  198. package/src/organization-model/organization-model.mdx +226 -219
  199. package/src/organization-model/published.ts +289 -235
  200. package/src/organization-model/resolve.ts +146 -91
  201. package/src/organization-model/schema.ts +790 -671
  202. package/src/organization-model/surface-projection.ts +212 -212
  203. package/src/organization-model/types.ts +177 -167
  204. package/src/platform/api/types.ts +38 -38
  205. package/src/platform/constants/versions.ts +3 -3
  206. package/src/platform/index.ts +23 -23
  207. package/src/platform/registry/__tests__/command-view.test.ts +10 -10
  208. package/src/platform/registry/__tests__/resource-link.test.ts +35 -35
  209. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +20 -20
  210. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -245
  211. package/src/platform/registry/__tests__/resource-registry.test.ts +2053 -2053
  212. package/src/platform/registry/__tests__/validation.test.ts +1347 -1347
  213. package/src/platform/registry/command-view.ts +10 -10
  214. package/src/platform/registry/index.ts +103 -103
  215. package/src/platform/registry/resource-link.ts +32 -32
  216. package/src/platform/registry/resource-registry.ts +890 -890
  217. package/src/platform/registry/serialization.ts +295 -295
  218. package/src/platform/registry/serialized-types.ts +166 -166
  219. package/src/platform/registry/stats-types.ts +68 -68
  220. package/src/platform/registry/types.ts +425 -425
  221. package/src/platform/registry/validation.ts +745 -745
  222. package/src/platform/utils/__tests__/validation.test.ts +1084 -1084
  223. package/src/platform/utils/validation.ts +425 -425
  224. package/src/projects/api-schemas.test.ts +39 -39
  225. package/src/projects/api-schemas.ts +291 -291
  226. package/src/reference/_generated/contracts.md +2101 -2096
  227. package/src/reference/glossary.md +76 -76
  228. package/src/scaffold-registry/__tests__/index.test.ts +206 -206
  229. package/src/scaffold-registry/__tests__/schema.test.ts +166 -166
  230. package/src/scaffold-registry/index.ts +392 -392
  231. package/src/scaffold-registry/schema.ts +243 -243
  232. package/src/server.ts +289 -289
  233. package/src/supabase/database.types.ts +3153 -3153
  234. package/src/test-utils/README.md +37 -37
  235. package/src/test-utils/entities.ts +108 -108
  236. package/src/test-utils/fixtures/memberships.ts +82 -82
  237. package/src/test-utils/index.ts +12 -12
  238. package/src/test-utils/organization-model.ts +65 -65
  239. package/src/test-utils/published.ts +6 -6
  240. package/src/test-utils/rls/RLSTestContext.ts +588 -588
  241. package/src/test-utils/test-utils.test.ts +44 -44
@@ -1,310 +1,409 @@
1
- import { describe, expect, it } from 'vitest'
2
- import { ZodError } from 'zod'
3
- import { bindResourceDescriptor } from '../../../platform/registry/types'
4
- import {
5
- DEFAULT_ORGANIZATION_MODEL_RESOURCES,
6
- EventIdSchema,
1
+ import { describe, expect, it } from 'vitest'
2
+ import { ZodError } from 'zod'
3
+ import { bindResourceDescriptor } from '../../../platform/registry/types'
4
+ import {
5
+ DEFAULT_ORGANIZATION_MODEL_RESOURCES,
6
+ EventIdSchema,
7
7
  ResourceEntrySchema,
8
8
  ResourceKindSchema,
9
+ ResourceOntologyBindingSchema,
9
10
  ResourcesDomainSchema,
10
- defineResource,
11
- defineResources
12
- } from '../../domains/resources'
13
- import { resolveOrganizationModel } from '../../resolve'
14
-
15
- const VALID_SYSTEM = {
16
- id: 'sys.lead-gen',
17
- order: 10,
18
- title: 'Lead Generation Pipeline',
19
- description: 'Coordinates prospecting, enrichment, qualification, and outreach preparation.',
20
- kind: 'operational' as const,
21
- status: 'active' as const
22
- }
23
-
24
- const VALID_ROLE = {
25
- id: 'role.sales-ops',
26
- order: 10,
27
- title: 'Sales Ops'
28
- }
29
-
30
- const WORKFLOW_RESOURCE = {
31
- id: 'LGN-01-company-scrape',
32
- order: 10,
33
- kind: 'workflow' as const,
34
- systemPath: 'sys.lead-gen',
35
- ownerRoleId: 'role.sales-ops',
36
- status: 'active' as const,
37
- actionKey: 'lead-gen.company.scrape'
38
- }
39
-
40
- const WORKFLOW_EVENT_EMISSION = {
41
- eventKey: 'processed',
42
- label: 'Processed',
43
- payloadSchema: 'leadgen.company.processed',
44
- lifecycle: 'active' as const
45
- }
46
-
47
- const AGENT_RESOURCE = {
48
- id: 'command-center-assistant',
49
- order: 20,
50
- kind: 'agent' as const,
51
- systemPath: 'sys.lead-gen',
52
- ownerRoleId: 'role.sales-ops',
53
- status: 'active' as const,
54
- agentKind: 'platform' as const,
55
- actsAsRoleId: 'role.sales-ops',
56
- sessionCapable: true,
57
- invocations: [{ kind: 'slash-command' as const, command: '/work handoff' }]
58
- }
59
-
60
- const INTEGRATION_RESOURCE = {
61
- id: 'attio-crm',
62
- order: 30,
63
- kind: 'integration' as const,
64
- systemPath: 'sys.lead-gen',
65
- ownerRoleId: 'role.sales-ops',
66
- status: 'active' as const,
67
- provider: 'attio'
68
- }
69
-
70
- const SCRIPT_RESOURCE = {
71
- id: 'leadgen-backfill-script',
72
- order: 40,
73
- kind: 'script' as const,
74
- systemPath: 'sys.lead-gen',
75
- ownerRoleId: 'role.sales-ops',
76
- status: 'active' as const,
77
- language: 'typescript' as const,
78
- source: {
79
- file: 'scripts/leadgen/backfill.ts'
80
- }
81
- }
82
-
83
- function resolveWithResources(resources: Record<string, unknown>) {
84
- return resolveOrganizationModel({
85
- roles: { 'role.sales-ops': VALID_ROLE },
86
- systems: { 'sys.lead-gen': VALID_SYSTEM },
87
- resources: resources as Record<string, typeof WORKFLOW_RESOURCE>
88
- })
89
- }
90
-
91
- describe('ResourceEntrySchema', () => {
92
- it('accepts workflow, agent, integration, and script descriptors with required systemPath', () => {
93
- expect(ResourceEntrySchema.safeParse(WORKFLOW_RESOURCE).success).toBe(true)
94
- expect(ResourceEntrySchema.safeParse(AGENT_RESOURCE).success).toBe(true)
95
- expect(ResourceEntrySchema.safeParse(INTEGRATION_RESOURCE).success).toBe(true)
96
- expect(ResourceEntrySchema.safeParse(SCRIPT_RESOURCE).success).toBe(true)
97
- })
98
-
99
- it('rejects resources without a systemPath', () => {
100
- const { systemPath: _systemPath, ...resourceWithoutSystem } = WORKFLOW_RESOURCE
101
-
102
- expect(ResourceEntrySchema.safeParse(resourceWithoutSystem).success).toBe(false)
103
- })
104
-
105
- it('rejects multi-system membership', () => {
106
- expect(
107
- ResourceEntrySchema.safeParse({
108
- ...WORKFLOW_RESOURCE,
109
- systemPath: ['sys.lead-gen', 'sys.crm']
110
- }).success
111
- ).toBe(false)
112
- })
113
-
114
- it('rejects an agent kind outside the code-side mirror enum', () => {
115
- expect(
116
- ResourceEntrySchema.safeParse({
117
- ...AGENT_RESOURCE,
118
- agentKind: 'runner'
119
- }).success
120
- ).toBe(false)
121
- })
122
-
123
- it('defaults agent invocations and accepts slash-command orchestration entries', () => {
124
- const result = ResourceEntrySchema.safeParse({
125
- ...AGENT_RESOURCE,
126
- invocations: undefined
127
- })
128
-
129
- expect(result.success).toBe(true)
130
- if (result.success) {
131
- expect(result.data.kind).toBe('agent')
132
- if (result.data.kind === 'agent') {
133
- expect(result.data.invocations).toEqual([])
134
- }
11
+ defineResource,
12
+ defineResources
13
+ } from '../../domains/resources'
14
+ import { resolveOrganizationModel } from '../../resolve'
15
+
16
+ const VALID_SYSTEM = {
17
+ id: 'sys.lead-gen',
18
+ order: 10,
19
+ title: 'Lead Generation Pipeline',
20
+ description: 'Coordinates prospecting, enrichment, qualification, and outreach preparation.',
21
+ kind: 'operational' as const,
22
+ status: 'active' as const
23
+ }
24
+
25
+ const VALID_ROLE = {
26
+ id: 'role.sales-ops',
27
+ order: 10,
28
+ title: 'Sales Ops'
29
+ }
30
+
31
+ const WORKFLOW_RESOURCE = {
32
+ id: 'LGN-01-company-scrape',
33
+ order: 10,
34
+ kind: 'workflow' as const,
35
+ systemPath: 'sys.lead-gen',
36
+ ownerRoleId: 'role.sales-ops',
37
+ status: 'active' as const,
38
+ actionKey: 'lead-gen.company.scrape',
39
+ codeRefs: [
40
+ {
41
+ path: 'operations/src/lead-gen/company-scrape/index.ts',
42
+ role: 'entrypoint' as const,
43
+ symbol: 'companyScrapeWorkflow',
44
+ description: 'Workflow definition bound to this OM resource descriptor.'
45
+ }
46
+ ]
47
+ }
48
+
49
+ const WORKFLOW_EVENT_EMISSION = {
50
+ eventKey: 'processed',
51
+ label: 'Processed',
52
+ payloadSchema: 'leadgen.company.processed',
53
+ lifecycle: 'active' as const
54
+ }
55
+
56
+ const AGENT_RESOURCE = {
57
+ id: 'command-center-assistant',
58
+ order: 20,
59
+ kind: 'agent' as const,
60
+ systemPath: 'sys.lead-gen',
61
+ ownerRoleId: 'role.sales-ops',
62
+ status: 'active' as const,
63
+ agentKind: 'platform' as const,
64
+ actsAsRoleId: 'role.sales-ops',
65
+ sessionCapable: true,
66
+ invocations: [{ kind: 'slash-command' as const, command: '/work handoff' }]
67
+ }
68
+
69
+ const INTEGRATION_RESOURCE = {
70
+ id: 'attio-crm',
71
+ order: 30,
72
+ kind: 'integration' as const,
73
+ systemPath: 'sys.lead-gen',
74
+ ownerRoleId: 'role.sales-ops',
75
+ status: 'active' as const,
76
+ provider: 'attio'
77
+ }
78
+
79
+ const SCRIPT_RESOURCE = {
80
+ id: 'leadgen-backfill-script',
81
+ order: 40,
82
+ kind: 'script' as const,
83
+ systemPath: 'sys.lead-gen',
84
+ ownerRoleId: 'role.sales-ops',
85
+ status: 'active' as const,
86
+ language: 'typescript' as const,
87
+ source: {
88
+ file: 'scripts/leadgen/backfill.ts'
89
+ }
90
+ }
91
+
92
+ function resolveWithResources(resources: Record<string, unknown>) {
93
+ return resolveOrganizationModel({
94
+ roles: { 'role.sales-ops': VALID_ROLE },
95
+ systems: { 'sys.lead-gen': VALID_SYSTEM },
96
+ resources: resources as Record<string, typeof WORKFLOW_RESOURCE>
97
+ })
98
+ }
99
+
100
+ describe('ResourceEntrySchema', () => {
101
+ it('accepts workflow, agent, integration, and script descriptors with required systemPath', () => {
102
+ expect(ResourceEntrySchema.safeParse(WORKFLOW_RESOURCE).success).toBe(true)
103
+ expect(ResourceEntrySchema.safeParse(AGENT_RESOURCE).success).toBe(true)
104
+ expect(ResourceEntrySchema.safeParse(INTEGRATION_RESOURCE).success).toBe(true)
105
+ expect(ResourceEntrySchema.safeParse(SCRIPT_RESOURCE).success).toBe(true)
106
+ })
107
+
108
+ it('rejects resources without a systemPath', () => {
109
+ const { systemPath: _systemPath, ...resourceWithoutSystem } = WORKFLOW_RESOURCE
110
+
111
+ expect(ResourceEntrySchema.safeParse(resourceWithoutSystem).success).toBe(false)
112
+ })
113
+
114
+ it('defaults codeRefs and accepts resource-level implementation breadcrumbs', () => {
115
+ const withCodeRefs = ResourceEntrySchema.safeParse(WORKFLOW_RESOURCE)
116
+ const withoutCodeRefs = ResourceEntrySchema.safeParse({
117
+ ...WORKFLOW_RESOURCE,
118
+ codeRefs: undefined
119
+ })
120
+
121
+ expect(withCodeRefs.success).toBe(true)
122
+ expect(withoutCodeRefs.success).toBe(true)
123
+
124
+ if (withCodeRefs.success) {
125
+ expect(withCodeRefs.data.codeRefs).toEqual(WORKFLOW_RESOURCE.codeRefs)
126
+ }
127
+ if (withoutCodeRefs.success) {
128
+ expect(withoutCodeRefs.data.codeRefs).toEqual([])
129
+ }
130
+ })
131
+
132
+ it('rejects codeRefs with an empty path', () => {
133
+ expect(
134
+ ResourceEntrySchema.safeParse({
135
+ ...WORKFLOW_RESOURCE,
136
+ codeRefs: [
137
+ {
138
+ path: ' ',
139
+ role: 'entrypoint'
140
+ }
141
+ ]
142
+ }).success
143
+ ).toBe(false)
144
+ })
145
+
146
+ it('rejects codeRefs with an invalid role', () => {
147
+ expect(
148
+ ResourceEntrySchema.safeParse({
149
+ ...WORKFLOW_RESOURCE,
150
+ codeRefs: [
151
+ {
152
+ path: 'operations/src/lead-gen/company-scrape/index.ts',
153
+ role: 'runtime'
154
+ }
155
+ ]
156
+ }).success
157
+ ).toBe(false)
158
+ })
159
+
160
+ it('rejects multi-system membership', () => {
161
+ expect(
162
+ ResourceEntrySchema.safeParse({
163
+ ...WORKFLOW_RESOURCE,
164
+ systemPath: ['sys.lead-gen', 'sys.crm']
165
+ }).success
166
+ ).toBe(false)
167
+ })
168
+
169
+ it('rejects an agent kind outside the code-side mirror enum', () => {
170
+ expect(
171
+ ResourceEntrySchema.safeParse({
172
+ ...AGENT_RESOURCE,
173
+ agentKind: 'runner'
174
+ }).success
175
+ ).toBe(false)
176
+ })
177
+
178
+ it('defaults agent invocations and accepts slash-command orchestration entries', () => {
179
+ const result = ResourceEntrySchema.safeParse({
180
+ ...AGENT_RESOURCE,
181
+ invocations: undefined
182
+ })
183
+
184
+ expect(result.success).toBe(true)
185
+ if (result.success) {
186
+ expect(result.data.kind).toBe('agent')
187
+ if (result.data.kind === 'agent') {
188
+ expect(result.data.invocations).toEqual([])
189
+ }
190
+ }
191
+
192
+ expect(ResourceEntrySchema.safeParse(AGENT_RESOURCE).success).toBe(true)
193
+ })
194
+
195
+ it('rejects malformed agent invocation entries', () => {
196
+ expect(
197
+ ResourceEntrySchema.safeParse({
198
+ ...AGENT_RESOURCE,
199
+ invocations: [{ kind: 'slash-command', command: 'work handoff' }]
200
+ }).success
201
+ ).toBe(false)
202
+ })
203
+
204
+ it('accepts event emissions on workflow and agent resources only', () => {
205
+ const workflowResult = ResourceEntrySchema.safeParse({
206
+ ...WORKFLOW_RESOURCE,
207
+ emits: [WORKFLOW_EVENT_EMISSION]
208
+ })
209
+ const agentResult = ResourceEntrySchema.safeParse({
210
+ ...AGENT_RESOURCE,
211
+ emits: [{ eventKey: 'approved', label: 'Approved' }]
212
+ })
213
+ const integrationResult = ResourceEntrySchema.safeParse({
214
+ ...INTEGRATION_RESOURCE,
215
+ emits: [{ eventKey: 'received', label: 'Received' }]
216
+ })
217
+
218
+ expect(workflowResult.success).toBe(true)
219
+ expect(agentResult.success).toBe(true)
220
+ expect(integrationResult.success).toBe(true)
221
+ if (workflowResult.success && workflowResult.data.kind === 'workflow') {
222
+ expect(workflowResult.data.emits).toEqual([WORKFLOW_EVENT_EMISSION])
223
+ }
224
+ if (agentResult.success && agentResult.data.kind === 'agent') {
225
+ expect(agentResult.data.emits).toEqual([{ eventKey: 'approved', label: 'Approved' }])
226
+ }
227
+ if (integrationResult.success && integrationResult.data.kind === 'integration') {
228
+ expect('emits' in integrationResult.data).toBe(false)
135
229
  }
136
-
137
- expect(ResourceEntrySchema.safeParse(AGENT_RESOURCE).success).toBe(true)
138
230
  })
139
231
 
140
- it('rejects malformed agent invocation entries', () => {
141
- expect(
142
- ResourceEntrySchema.safeParse({
143
- ...AGENT_RESOURCE,
144
- invocations: [{ kind: 'slash-command', command: 'work handoff' }]
145
- }).success
146
- ).toBe(false)
147
- })
148
-
149
- it('accepts event emissions on workflow and agent resources only', () => {
232
+ it('accepts optional ontology bindings on resource variants without changing top-level event emissions', () => {
233
+ const ontology = {
234
+ implements: ['sys.lead-gen:action/company.scrape'],
235
+ reads: ['sys.lead-gen:object/company'],
236
+ writes: ['sys.lead-gen:object/company'],
237
+ usesCatalogs: ['sys.lead-gen:catalog/build-template'],
238
+ emits: ['sys.lead-gen:event/company.scraped']
239
+ }
150
240
  const workflowResult = ResourceEntrySchema.safeParse({
151
241
  ...WORKFLOW_RESOURCE,
242
+ ontology,
152
243
  emits: [WORKFLOW_EVENT_EMISSION]
153
244
  })
154
245
  const agentResult = ResourceEntrySchema.safeParse({
155
246
  ...AGENT_RESOURCE,
156
- emits: [{ eventKey: 'approved', label: 'Approved' }]
247
+ ontology
157
248
  })
158
249
  const integrationResult = ResourceEntrySchema.safeParse({
159
250
  ...INTEGRATION_RESOURCE,
160
- emits: [{ eventKey: 'received', label: 'Received' }]
251
+ ontology
252
+ })
253
+ const scriptResult = ResourceEntrySchema.safeParse({
254
+ ...SCRIPT_RESOURCE,
255
+ ontology
161
256
  })
162
257
 
163
258
  expect(workflowResult.success).toBe(true)
164
259
  expect(agentResult.success).toBe(true)
165
260
  expect(integrationResult.success).toBe(true)
261
+ expect(scriptResult.success).toBe(true)
166
262
  if (workflowResult.success && workflowResult.data.kind === 'workflow') {
263
+ expect(workflowResult.data.ontology).toEqual(ontology)
167
264
  expect(workflowResult.data.emits).toEqual([WORKFLOW_EVENT_EMISSION])
168
265
  }
169
- if (agentResult.success && agentResult.data.kind === 'agent') {
170
- expect(agentResult.data.emits).toEqual([{ eventKey: 'approved', label: 'Approved' }])
171
- }
172
- if (integrationResult.success && integrationResult.data.kind === 'integration') {
173
- expect('emits' in integrationResult.data).toBe(false)
174
- }
175
- })
176
-
177
- it('validates derived event id format', () => {
178
- expect(EventIdSchema.parse('crm.deal:won')).toBe('crm.deal:won')
179
- expect(EventIdSchema.parse('LGN-01-company-scrape:processed')).toBe('LGN-01-company-scrape:processed')
180
- expect(() => EventIdSchema.parse('crm.deal.won')).toThrow()
181
- })
182
- })
183
-
184
- describe('ResourcesDomainSchema', () => {
185
- it('defaults resources to an empty record when omitted', () => {
186
- const result = ResourcesDomainSchema.safeParse({})
187
-
188
- expect(result.success).toBe(true)
189
- if (result.success) {
190
- expect(result.data).toEqual(DEFAULT_ORGANIZATION_MODEL_RESOURCES)
191
- }
192
- })
193
-
194
- it.each(['workflow', 'agent', 'integration', 'script'] as const)('accepts kind "%s"', (kind) => {
195
- expect(ResourceKindSchema.safeParse(kind).success).toBe(true)
196
- })
197
- })
198
-
199
- describe('resolveOrganizationModel - resources domain integration', () => {
200
- it('accepts valid resources with system and role references', () => {
201
- const model = resolveWithResources({
202
- 'LGN-01-company-scrape': WORKFLOW_RESOURCE,
203
- 'command-center-assistant': AGENT_RESOURCE,
204
- 'attio-crm': INTEGRATION_RESOURCE,
205
- 'leadgen-backfill-script': SCRIPT_RESOURCE
206
- })
207
-
208
- expect(Object.keys(model.resources)).toHaveLength(4)
209
- })
210
-
211
- it('throws when a resource entry id does not match its map key', () => {
212
- expect(() =>
213
- resolveWithResources({
214
- 'LGN-01-company-scrape': WORKFLOW_RESOURCE,
215
- 'wrong-key': {
216
- ...WORKFLOW_RESOURCE,
217
- id: 'LGN-01-company-scrape'
218
- }
219
- })
220
- ).toThrow()
221
- })
222
-
223
- it('throws when systemPath references an unknown system', () => {
224
- expect(() =>
225
- resolveWithResources({
226
- 'LGN-01-company-scrape': {
227
- ...WORKFLOW_RESOURCE,
228
- systemPath: 'sys.missing'
229
- }
230
- })
231
- ).toThrow(/unknown system path \\"sys\.missing\\"/)
232
- })
233
-
234
- it('reports a dangling resource systemPath on the resource systemPath issue path', () => {
235
- let error: unknown
236
-
237
- try {
238
- resolveWithResources({
239
- 'LGN-01-company-scrape': {
240
- ...WORKFLOW_RESOURCE,
241
- systemPath: 'sys.missing'
242
- }
243
- })
244
- } catch (caught) {
245
- error = caught
246
- }
247
-
248
- expect(error).toBeInstanceOf(ZodError)
249
- if (!(error instanceof ZodError)) {
250
- throw new Error('Expected resolveOrganizationModel to throw a ZodError')
251
- }
252
-
253
- expect(error.issues).toEqual(
254
- expect.arrayContaining([
255
- expect.objectContaining({
256
- path: ['resources', 'LGN-01-company-scrape', 'systemPath']
257
- })
258
- ])
259
- )
260
- })
261
-
262
- it('throws when ownerRoleId references an unknown role', () => {
263
- expect(() =>
264
- resolveWithResources({
265
- 'LGN-01-company-scrape': {
266
- ...WORKFLOW_RESOURCE,
267
- ownerRoleId: 'role.missing'
268
- }
269
- })
270
- ).toThrow(/unknown ownerRoleId \\"role\.missing\\"/)
271
- })
272
-
273
- it('throws when agent actsAsRoleId references an unknown role', () => {
274
- expect(() =>
275
- resolveWithResources({
276
- 'command-center-assistant': {
277
- ...AGENT_RESOURCE,
278
- actsAsRoleId: 'role.missing'
279
- }
280
- })
281
- ).toThrow(/unknown actsAsRoleId \\"role\.missing\\"/)
282
266
  })
283
- })
284
267
 
285
- describe('descriptor helper contract', () => {
286
- it('preserves typed descriptor exports through defineResource and defineResources', () => {
287
- const workflow = defineResource(WORKFLOW_RESOURCE)
288
- const resources = defineResources({
289
- companyScrape: WORKFLOW_RESOURCE,
290
- commandCenterAssistant: AGENT_RESOURCE
291
- })
292
-
293
- expect(workflow.id).toBe('LGN-01-company-scrape')
294
- expect(resources.commandCenterAssistant.agentKind).toBe('platform')
268
+ it('rejects malformed ontology binding ids', () => {
269
+ expect(
270
+ ResourceOntologyBindingSchema.safeParse({
271
+ implements: ['sys.lead-gen/action/company.scrape']
272
+ }).success
273
+ ).toBe(false)
295
274
  })
296
275
 
297
- it('derives runtime resourceId and type from the descriptor', () => {
298
- const bound = bindResourceDescriptor({
299
- resource: WORKFLOW_RESOURCE,
300
- name: 'Company Scrape',
301
- description: 'Scrapes company data for lead generation.',
302
- version: '1.0.0',
303
- status: 'prod'
304
- })
305
-
306
- expect(bound.resourceId).toBe('LGN-01-company-scrape')
307
- expect(bound.type).toBe('workflow')
308
- expect(bound.resource).toBe(WORKFLOW_RESOURCE)
309
- })
310
- })
276
+ it('validates derived event id format', () => {
277
+ expect(EventIdSchema.parse('crm.deal:won')).toBe('crm.deal:won')
278
+ expect(EventIdSchema.parse('LGN-01-company-scrape:processed')).toBe('LGN-01-company-scrape:processed')
279
+ expect(() => EventIdSchema.parse('crm.deal.won')).toThrow()
280
+ })
281
+ })
282
+
283
+ describe('ResourcesDomainSchema', () => {
284
+ it('defaults resources to an empty record when omitted', () => {
285
+ const result = ResourcesDomainSchema.safeParse({})
286
+
287
+ expect(result.success).toBe(true)
288
+ if (result.success) {
289
+ expect(result.data).toEqual(DEFAULT_ORGANIZATION_MODEL_RESOURCES)
290
+ }
291
+ })
292
+
293
+ it.each(['workflow', 'agent', 'integration', 'script'] as const)('accepts kind "%s"', (kind) => {
294
+ expect(ResourceKindSchema.safeParse(kind).success).toBe(true)
295
+ })
296
+ })
297
+
298
+ describe('resolveOrganizationModel - resources domain integration', () => {
299
+ it('accepts valid resources with system and role references', () => {
300
+ const model = resolveWithResources({
301
+ 'LGN-01-company-scrape': WORKFLOW_RESOURCE,
302
+ 'command-center-assistant': AGENT_RESOURCE,
303
+ 'attio-crm': INTEGRATION_RESOURCE,
304
+ 'leadgen-backfill-script': SCRIPT_RESOURCE
305
+ })
306
+
307
+ expect(Object.keys(model.resources)).toHaveLength(4)
308
+ })
309
+
310
+ it('throws when a resource entry id does not match its map key', () => {
311
+ expect(() =>
312
+ resolveWithResources({
313
+ 'LGN-01-company-scrape': WORKFLOW_RESOURCE,
314
+ 'wrong-key': {
315
+ ...WORKFLOW_RESOURCE,
316
+ id: 'LGN-01-company-scrape'
317
+ }
318
+ })
319
+ ).toThrow()
320
+ })
321
+
322
+ it('throws when systemPath references an unknown system', () => {
323
+ expect(() =>
324
+ resolveWithResources({
325
+ 'LGN-01-company-scrape': {
326
+ ...WORKFLOW_RESOURCE,
327
+ systemPath: 'sys.missing'
328
+ }
329
+ })
330
+ ).toThrow(/unknown system path \\"sys\.missing\\"/)
331
+ })
332
+
333
+ it('reports a dangling resource systemPath on the resource systemPath issue path', () => {
334
+ let error: unknown
335
+
336
+ try {
337
+ resolveWithResources({
338
+ 'LGN-01-company-scrape': {
339
+ ...WORKFLOW_RESOURCE,
340
+ systemPath: 'sys.missing'
341
+ }
342
+ })
343
+ } catch (caught) {
344
+ error = caught
345
+ }
346
+
347
+ expect(error).toBeInstanceOf(ZodError)
348
+ if (!(error instanceof ZodError)) {
349
+ throw new Error('Expected resolveOrganizationModel to throw a ZodError')
350
+ }
351
+
352
+ expect(error.issues).toEqual(
353
+ expect.arrayContaining([
354
+ expect.objectContaining({
355
+ path: ['resources', 'LGN-01-company-scrape', 'systemPath']
356
+ })
357
+ ])
358
+ )
359
+ })
360
+
361
+ it('throws when ownerRoleId references an unknown role', () => {
362
+ expect(() =>
363
+ resolveWithResources({
364
+ 'LGN-01-company-scrape': {
365
+ ...WORKFLOW_RESOURCE,
366
+ ownerRoleId: 'role.missing'
367
+ }
368
+ })
369
+ ).toThrow(/unknown ownerRoleId \\"role\.missing\\"/)
370
+ })
371
+
372
+ it('throws when agent actsAsRoleId references an unknown role', () => {
373
+ expect(() =>
374
+ resolveWithResources({
375
+ 'command-center-assistant': {
376
+ ...AGENT_RESOURCE,
377
+ actsAsRoleId: 'role.missing'
378
+ }
379
+ })
380
+ ).toThrow(/unknown actsAsRoleId \\"role\.missing\\"/)
381
+ })
382
+ })
383
+
384
+ describe('descriptor helper contract', () => {
385
+ it('preserves typed descriptor exports through defineResource and defineResources', () => {
386
+ const workflow = defineResource(WORKFLOW_RESOURCE)
387
+ const resources = defineResources({
388
+ companyScrape: WORKFLOW_RESOURCE,
389
+ commandCenterAssistant: AGENT_RESOURCE
390
+ })
391
+
392
+ expect(workflow.id).toBe('LGN-01-company-scrape')
393
+ expect(resources.commandCenterAssistant.agentKind).toBe('platform')
394
+ })
395
+
396
+ it('derives runtime resourceId and type from the descriptor', () => {
397
+ const bound = bindResourceDescriptor({
398
+ resource: WORKFLOW_RESOURCE,
399
+ name: 'Company Scrape',
400
+ description: 'Scrapes company data for lead generation.',
401
+ version: '1.0.0',
402
+ status: 'prod'
403
+ })
404
+
405
+ expect(bound.resourceId).toBe('LGN-01-company-scrape')
406
+ expect(bound.type).toBe('workflow')
407
+ expect(bound.resource).toBe(WORKFLOW_RESOURCE)
408
+ })
409
+ })