@treeseed/sdk 0.13.0-rc.13 → 0.13.0-rc.131

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 (558) hide show
  1. package/README.md +69 -9
  2. package/dist/accounts/account-contracts.d.ts +6 -0
  3. package/dist/agent-capacity/contracts/capacity/assignments/agent-execution.d.ts +5485 -0
  4. package/dist/agent-capacity/contracts/capacity/assignments/agent-execution.js +242 -0
  5. package/dist/agent-capacity/contracts/capacity/assignments/assignment-context-pack.d.ts +304 -0
  6. package/dist/agent-capacity/contracts/capacity/assignments/assignment-context-pack.js +44 -0
  7. package/dist/agent-capacity/contracts/capacity/assignments/assignment-path.d.ts +2 -0
  8. package/dist/agent-capacity/contracts/capacity/assignments/assignment-path.js +13 -0
  9. package/dist/agent-capacity/contracts/capacity/assignments/assignment-records.d.ts +23 -60
  10. package/dist/agent-capacity/contracts/capacity/assignments/context-pack-compiler.d.ts +25 -0
  11. package/dist/agent-capacity/contracts/capacity/assignments/context-pack-compiler.js +67 -0
  12. package/dist/agent-capacity/contracts/capacity/communication/communication-records.d.ts +1 -1
  13. package/dist/agent-capacity/contracts/capacity/providers/supply-policy.d.ts +126 -3
  14. package/dist/agent-capacity/contracts/capacity/providers/supply-policy.js +35 -1
  15. package/dist/agent-capacity/contracts/capacity/workdays/assignment-allocation.d.ts +80 -0
  16. package/dist/agent-capacity/contracts/capacity/workdays/assignment-allocation.js +121 -0
  17. package/dist/agent-capacity/contracts/capacity/workdays/capability-accounting.d.ts +103 -0
  18. package/dist/agent-capacity/contracts/capacity/workdays/capability-accounting.js +51 -0
  19. package/dist/agent-capacity/contracts/capacity/workdays/workday-allocation.d.ts +490 -0
  20. package/dist/agent-capacity/contracts/capacity/workdays/workday-allocation.js +170 -0
  21. package/dist/agent-capacity/contracts/capacity/workdays/workday-records.d.ts +210 -91
  22. package/dist/agent-capacity/contracts/capacity/workdays/workday-records.js +19 -0
  23. package/dist/agent-capacity/contracts/configuration/configuration.d.ts +1 -1
  24. package/dist/agent-capacity/contracts/configuration/configuration.js +1 -3
  25. package/dist/agent-capacity/contracts/operations/agent-team-clone.d.ts +218 -0
  26. package/dist/agent-capacity/contracts/operations/agent-team-clone.js +57 -0
  27. package/dist/agent-capacity/contracts/projects/agents/project-agent-class.d.ts +119 -24
  28. package/dist/agent-capacity/contracts/projects/agents/project-agent-class.js +16 -0
  29. package/dist/agent-capacity/contracts/runtime/runtime-observability.d.ts +2 -154
  30. package/dist/agent-capacity/contracts/support/agent-atlas.d.ts +0 -13
  31. package/dist/agent-capacity/contracts/support/execution-graph.d.ts +1291 -0
  32. package/dist/agent-capacity/contracts/support/execution-graph.js +122 -0
  33. package/dist/agent-capacity/contracts/support/financial-records.d.ts +3 -6
  34. package/dist/agent-capacity/contracts/support/planning-records.d.ts +1 -87
  35. package/dist/agent-capacity/contracts/support/time-capacity.d.ts +0 -14
  36. package/dist/agent-capacity/contracts/support/time-capacity.js +1 -8
  37. package/dist/agent-capacity/grant.d.ts +34 -0
  38. package/dist/agent-capacity/grant.js +4 -0
  39. package/dist/agent-capacity/validation/activity-profile.d.ts +1 -1
  40. package/dist/agent-capacity/validation/activity-profile.js +3 -259
  41. package/dist/agent-capacity/validation/agent-definition-schema.d.ts +2538 -9020
  42. package/dist/agent-capacity/validation/agent-definition-schema.js +59 -181
  43. package/dist/agent-capacity/validation/agent-lab-forensics-schema.d.ts +25 -25
  44. package/dist/agent-capacity/validation/agent-lab-forensics-schema.js +0 -1
  45. package/dist/agent-capacity/validation/assignment-records.d.ts +1 -6
  46. package/dist/agent-capacity/validation/assignment-records.js +49 -35
  47. package/dist/agent-capacity/validation/configuration.d.ts +1 -1
  48. package/dist/agent-capacity/validation/configuration.js +2 -7
  49. package/dist/agent-capacity/validation/execution/execution-graph.d.ts +1 -0
  50. package/dist/agent-capacity/validation/execution/execution-graph.js +16 -0
  51. package/dist/agent-capacity/validation/grant.d.ts +11 -0
  52. package/dist/agent-capacity/validation/grant.js +31 -0
  53. package/dist/agent-capacity/validation/index.d.ts +2 -1
  54. package/dist/agent-capacity/validation/index.js +2 -1
  55. package/dist/agent-capacity/workday.d.ts +13 -4
  56. package/dist/agent-capacity/workday.js +10 -26
  57. package/dist/capacity/agents/agent-capacity.d.ts +11 -4
  58. package/dist/capacity/agents/agent-capacity.js +9 -3
  59. package/dist/capacity-provider/capability-ontology.d.ts +1495 -0
  60. package/dist/capacity-provider/capability-ontology.js +221 -0
  61. package/dist/capacity-provider/client.d.ts +78 -3
  62. package/dist/capacity-provider/client.js +22 -10
  63. package/dist/capacity-provider/contracts/capacity-facts.d.ts +13 -0
  64. package/dist/capacity-provider/contracts/environment-profiles.d.ts +255 -0
  65. package/dist/capacity-provider/contracts/environment-profiles.js +71 -0
  66. package/dist/capacity-provider/contracts/governance.d.ts +110 -51
  67. package/dist/capacity-provider/contracts/index.d.ts +3 -0
  68. package/dist/capacity-provider/contracts/index.js +3 -0
  69. package/dist/capacity-provider/core-capability-catalog.d.ts +47 -0
  70. package/dist/capacity-provider/core-capability-catalog.js +49 -0
  71. package/dist/capacity-provider/environment-catalog.d.ts +877 -0
  72. package/dist/capacity-provider/environment-catalog.js +116 -0
  73. package/dist/capacity-provider/index.d.ts +5 -0
  74. package/dist/capacity-provider/index.js +5 -0
  75. package/dist/capacity-provider/install-configuration.d.ts +39 -0
  76. package/dist/capacity-provider/install-configuration.js +18 -0
  77. package/dist/capacity-provider/sandbox-contracts.d.ts +602 -0
  78. package/dist/capacity-provider/sandbox-contracts.js +90 -0
  79. package/dist/capacity-provider/sandbox.d.ts +2 -0
  80. package/dist/capacity-provider/sandbox.js +2 -0
  81. package/dist/capacity-provider/source-workspace.d.ts +740 -0
  82. package/dist/capacity-provider/source-workspace.js +130 -0
  83. package/dist/capacity-provider/validation.d.ts +11 -3
  84. package/dist/capacity-provider/validation.js +136 -70
  85. package/dist/configuration/secrets-capability.d.ts +5 -1
  86. package/dist/configuration/secrets-capability.js +5 -1
  87. package/dist/content/contracts.d.ts +1 -1
  88. package/dist/content/validation/agent-operational-content-schemas.d.ts +430 -777
  89. package/dist/content/validation/agent-operational-content-schemas.js +31 -57
  90. package/dist/content/validation/auxiliary-content-schemas.d.ts +144 -144
  91. package/dist/content/validation/content-model-schemas.d.ts +16063 -19764
  92. package/dist/content/validation/content-model-schemas.js +350 -98
  93. package/dist/content/validation/portable-content-data.d.ts +751 -1782
  94. package/dist/content/validation/portable-content-data.js +10 -4
  95. package/dist/content/validation/schema-constraints.d.ts +80 -0
  96. package/dist/content/validation/schema-constraints.js +173 -0
  97. package/dist/deployment/ai/storage.d.ts +158 -0
  98. package/dist/deployment/ai/storage.js +32 -0
  99. package/dist/deployment/ai-hosting.d.ts +297 -0
  100. package/dist/deployment/ai-hosting.js +63 -0
  101. package/dist/deployment/ai-instance.d.ts +65 -0
  102. package/dist/deployment/ai-instance.js +30 -0
  103. package/dist/deployment/ai-mode.d.ts +454 -0
  104. package/dist/deployment/ai-mode.js +67 -0
  105. package/dist/deployment/canonical.d.ts +2 -0
  106. package/dist/deployment/canonical.js +17 -0
  107. package/dist/deployment/catalog.d.ts +16 -0
  108. package/dist/deployment/catalog.js +48 -0
  109. package/dist/deployment/hosted-topology-template.d.ts +449 -0
  110. package/dist/deployment/hosted-topology-template.js +56 -0
  111. package/dist/deployment/hosted-topology.d.ts +2698 -0
  112. package/dist/deployment/hosted-topology.js +468 -0
  113. package/dist/deployment/index.d.ts +13 -0
  114. package/dist/deployment/index.js +13 -0
  115. package/dist/deployment/postgres/contracts.d.ts +418 -0
  116. package/dist/deployment/postgres/contracts.js +83 -0
  117. package/dist/deployment/postgres/requirements.d.ts +15 -0
  118. package/dist/deployment/postgres/requirements.js +32 -0
  119. package/dist/deployment/postgres/transfer.d.ts +97 -0
  120. package/dist/deployment/postgres/transfer.js +29 -0
  121. package/dist/deployment/schemas.d.ts +8625 -0
  122. package/dist/deployment/schemas.js +455 -0
  123. package/dist/deployment/topology.d.ts +9 -0
  124. package/dist/deployment/topology.js +35 -0
  125. package/dist/development/index.d.ts +1 -0
  126. package/dist/development/index.js +1 -0
  127. package/dist/development/schemas.d.ts +3594 -0
  128. package/dist/development/schemas.js +204 -0
  129. package/dist/development/session-migration.d.ts +3 -0
  130. package/dist/development/session-migration.js +25 -0
  131. package/dist/entrypoints/clients/control-plane-client.d.ts +9 -1
  132. package/dist/entrypoints/clients/control-plane-client.js +17 -5
  133. package/dist/graph/context-query-contracts.d.ts +16 -1
  134. package/dist/graph/context-query-contracts.js +6 -1
  135. package/dist/guarantees/evidence-trust.d.ts +32 -0
  136. package/dist/guarantees/evidence-trust.js +47 -0
  137. package/dist/guarantees/index.d.ts +154 -0
  138. package/dist/guarantees/index.js +44 -0
  139. package/dist/identity/browser-session.d.ts +233 -0
  140. package/dist/identity/browser-session.js +51 -0
  141. package/dist/identity/contracts.d.ts +191 -0
  142. package/dist/identity/contracts.js +77 -0
  143. package/dist/identity/index.d.ts +3 -0
  144. package/dist/identity/index.js +3 -0
  145. package/dist/identity/runtime.d.ts +186 -0
  146. package/dist/identity/runtime.js +49 -0
  147. package/dist/knowledge/contracts.d.ts +9 -2
  148. package/dist/knowledge/contracts.js +2 -2
  149. package/dist/model-registry/agent-operational-models.d.ts +1 -1
  150. package/dist/model-registry/agent-operational-models.js +1 -4
  151. package/dist/model-registry/build-builtin-model-registry.js +44 -72
  152. package/dist/model-registry/discussion-models.js +0 -1
  153. package/dist/operator-contracts/canonical-command-tree.js +415 -44
  154. package/dist/operator-contracts/catalog/admin-account-team-operations.d.ts +36 -0
  155. package/dist/operator-contracts/catalog/admin-account-team-operations.js +52 -0
  156. package/dist/operator-contracts/catalog/agents/agent-team-clone-operations.d.ts +75 -0
  157. package/dist/operator-contracts/catalog/agents/agent-team-clone-operations.js +42 -0
  158. package/dist/operator-contracts/catalog/capability-ontology-operations.d.ts +163 -0
  159. package/dist/operator-contracts/catalog/capability-ontology-operations.js +24 -0
  160. package/dist/operator-contracts/catalog/commands/command-tree-builders.d.ts +62 -0
  161. package/dist/operator-contracts/catalog/commands/command-tree-builders.js +191 -0
  162. package/dist/operator-contracts/catalog/communication-operations.d.ts +457 -0
  163. package/dist/operator-contracts/catalog/communication-operations.js +92 -0
  164. package/dist/operator-contracts/catalog/control-plane-catalog.d.ts +6 -0
  165. package/dist/operator-contracts/catalog/control-plane-catalog.js +18 -0
  166. package/dist/operator-contracts/catalog/execution/execution-operations.d.ts +36 -0
  167. package/dist/operator-contracts/catalog/execution/execution-operations.js +39 -0
  168. package/dist/operator-contracts/catalog/hosted-topology-operations.d.ts +399 -0
  169. package/dist/operator-contracts/catalog/hosted-topology-operations.js +79 -0
  170. package/dist/operator-contracts/catalog/inbox-operations.d.ts +265 -0
  171. package/dist/operator-contracts/catalog/inbox-operations.js +36 -0
  172. package/dist/operator-contracts/catalog/infrastructure/ai-instance-operations.d.ts +53 -0
  173. package/dist/operator-contracts/catalog/infrastructure/ai-instance-operations.js +24 -0
  174. package/dist/operator-contracts/catalog/infrastructure/command-tree-paths.d.ts +3 -0
  175. package/dist/operator-contracts/catalog/infrastructure/command-tree-paths.js +15 -0
  176. package/dist/operator-contracts/catalog/knowledge-share-operations.d.ts +127 -0
  177. package/dist/operator-contracts/catalog/knowledge-share-operations.js +25 -0
  178. package/dist/operator-contracts/catalog/provider-environment-commands.d.ts +4 -0
  179. package/dist/operator-contracts/catalog/provider-environment-commands.js +69 -0
  180. package/dist/operator-contracts/catalog/provider-environment-operations.d.ts +41 -0
  181. package/dist/operator-contracts/catalog/provider-environment-operations.js +61 -0
  182. package/dist/operator-contracts/catalog/services/identity-commands.d.ts +2 -0
  183. package/dist/operator-contracts/catalog/services/identity-commands.js +13 -0
  184. package/dist/operator-contracts/catalog/services/secret-commands.d.ts +2 -0
  185. package/dist/operator-contracts/catalog/services/secret-commands.js +31 -0
  186. package/dist/operator-contracts/catalog/services/secret-operations.d.ts +70 -0
  187. package/dist/operator-contracts/catalog/services/secret-operations.js +52 -0
  188. package/dist/operator-contracts/catalog/treeai-operations.d.ts +13 -0
  189. package/dist/operator-contracts/catalog/treeai-operations.js +61 -0
  190. package/dist/operator-contracts/catalog/workdays/profile-commands.d.ts +4 -0
  191. package/dist/operator-contracts/catalog/workdays/profile-commands.js +20 -0
  192. package/dist/operator-contracts/catalog/workdays/profile-operations.d.ts +41 -0
  193. package/dist/operator-contracts/catalog/workdays/profile-operations.js +50 -0
  194. package/dist/operator-contracts/catalog/workdays/selection-commands.d.ts +3 -0
  195. package/dist/operator-contracts/catalog/workdays/selection-commands.js +28 -0
  196. package/dist/operator-contracts/command-tree.d.ts +29 -0
  197. package/dist/operator-contracts/command-tree.js +50 -0
  198. package/dist/operator-contracts/communication/addressing.d.ts +8 -0
  199. package/dist/operator-contracts/communication/addressing.js +57 -0
  200. package/dist/operator-contracts/communication/contracts.d.ts +1966 -0
  201. package/dist/operator-contracts/communication/contracts.js +195 -0
  202. package/dist/operator-contracts/control-plane-operation.d.ts +15 -1
  203. package/dist/operator-contracts/control-plane-operation.js +14 -6
  204. package/dist/operator-contracts/control-plane-operations.d.ts +2496 -328
  205. package/dist/operator-contracts/control-plane-operations.js +282 -129
  206. package/dist/operator-contracts/inbox/contracts.d.ts +1111 -0
  207. package/dist/operator-contracts/inbox/contracts.js +138 -0
  208. package/dist/operator-contracts/index.d.ts +6 -1
  209. package/dist/operator-contracts/index.js +6 -1
  210. package/dist/operator-contracts/knowledge/contracts.d.ts +130 -0
  211. package/dist/operator-contracts/knowledge/contracts.js +39 -0
  212. package/dist/operator-contracts/mcp.d.ts +5 -0
  213. package/dist/operator-contracts/mcp.js +62 -0
  214. package/dist/operator-contracts/oauth.d.ts +45 -0
  215. package/dist/operator-contracts/oauth.js +7 -0
  216. package/dist/operator-contracts/operation-builder.d.ts +18 -0
  217. package/dist/operator-contracts/operation-builder.js +78 -0
  218. package/dist/operator-contracts/seed/seed-bundle.d.ts +138 -0
  219. package/dist/operator-contracts/seed/seed-bundle.js +68 -0
  220. package/dist/operator-contracts/workday-lifecycle.d.ts +383 -28
  221. package/dist/operator-contracts/workday-lifecycle.js +124 -17
  222. package/dist/platform/agent-schema-verification.d.ts +3 -0
  223. package/dist/platform/agent-schema-verification.js +377 -0
  224. package/dist/platform/contracts.d.ts +429 -0
  225. package/dist/platform/contracts.js +93 -0
  226. package/dist/platform/index.d.ts +6 -0
  227. package/dist/platform/index.js +6 -0
  228. package/dist/platform/inventory.d.ts +11 -0
  229. package/dist/platform/inventory.js +53 -0
  230. package/dist/platform/project-create.d.ts +49 -0
  231. package/dist/platform/project-create.js +75 -0
  232. package/dist/platform/schemas.d.ts +1094 -0
  233. package/dist/platform/schemas.js +99 -0
  234. package/dist/platform/verification.d.ts +9 -0
  235. package/dist/platform/verification.js +114 -0
  236. package/dist/platform/workset.d.ts +21 -0
  237. package/dist/platform/workset.js +106 -0
  238. package/dist/sdk-types/support/planning-policy.d.ts +1 -1
  239. package/dist/sdk-types/support/sdk-model-names.d.ts +1 -1
  240. package/dist/sdk-types/support/sdk-model-names.js +0 -3
  241. package/dist/sdk-types/support/sdk-search-request.d.ts +2 -2
  242. package/dist/secrets-capability/github-actions-encryption.d.ts +2 -0
  243. package/dist/secrets-capability/github-actions-encryption.js +11 -0
  244. package/dist/secrets-capability/provider-operation-contracts.d.ts +15 -1
  245. package/dist/secrets-capability/secret-contracts.d.ts +33 -0
  246. package/dist/secrets-capability/secret-contracts.js +49 -0
  247. package/dist/secrets-capability/service-provider-contracts.d.ts +5 -3
  248. package/dist/secrets-capability/service-provider-contracts.js +66 -50
  249. package/dist/secrets-capability/shared-access.d.ts +51 -0
  250. package/dist/secrets-capability/shared-access.js +36 -0
  251. package/dist/secrets-capability/shared-resources.d.ts +376 -0
  252. package/dist/secrets-capability/shared-resources.js +91 -0
  253. package/dist/secrets-capability/vault-contracts.d.ts +132 -0
  254. package/dist/secrets-capability/vault-contracts.js +56 -0
  255. package/dist/security/encrypted-envelope.d.ts +177 -0
  256. package/dist/security/encrypted-envelope.js +34 -0
  257. package/dist/security/envelope-codec.d.ts +38 -0
  258. package/dist/security/envelope-codec.js +96 -0
  259. package/dist/security/index.d.ts +2 -0
  260. package/dist/security/index.js +2 -0
  261. package/dist/site-contracts/catalog.d.ts +16 -0
  262. package/dist/site-contracts/catalog.js +19 -0
  263. package/dist/site-contracts/cloudflare.d.ts +48 -0
  264. package/dist/site-contracts/platform.d.ts +94 -0
  265. package/dist/site-contracts/plugin.d.ts +63 -0
  266. package/dist/site-contracts/plugin.js +26 -0
  267. package/dist/treeai/catalog.d.ts +1 -0
  268. package/dist/treeai/catalog.js +1 -0
  269. package/dist/treeai/client.d.ts +793 -0
  270. package/dist/treeai/client.js +44 -0
  271. package/dist/treeai/contract.d.ts +41 -0
  272. package/dist/treeai/contract.js +51 -0
  273. package/dist/treeai/generated/upstream.d.ts +770 -0
  274. package/dist/treeai/generated/upstream.js +4 -0
  275. package/dist/treeai/index.d.ts +4 -0
  276. package/dist/treeai/index.js +4 -0
  277. package/dist/treedx/client.d.ts +605 -0
  278. package/dist/treedx/client.js +39 -0
  279. package/dist/treedx/contract.d.ts +32 -0
  280. package/dist/treedx/contract.js +63 -0
  281. package/dist/treedx/index.d.ts +3 -0
  282. package/dist/treedx/index.js +3 -0
  283. package/dist/treedx/types.d.ts +294 -7
  284. package/dist/treedx/types.js +44 -7
  285. package/dist/types/agents/agent-activity-profile.d.ts +43 -98
  286. package/dist/types/agents/agent-activity-profile.js +23 -0
  287. package/dist/types/agents/agent-trigger-kinds.d.ts +3 -5
  288. package/dist/types/agents/agent-trigger-kinds.js +1 -13
  289. package/dist/types/agents/execution-run-ref.d.ts +1 -8
  290. package/guarantees/agent/golden/component-boundaries.guarantee.yaml +12 -0
  291. package/guarantees/agent/golden/product-custody.guarantee.yaml +12 -0
  292. package/guarantees/agent/golden/product.guarantee.yaml +12 -0
  293. package/guarantees/agent/golden/scenes/component-boundaries.scene.yaml +864 -0
  294. package/guarantees/agent/golden/scenes/product-custody.scene.yaml +53 -0
  295. package/guarantees/agent/golden/scenes/product.scene.yaml +8 -0
  296. package/guarantees/verifiers/golden.verifiers.yaml +1474 -0
  297. package/package.json +72 -13
  298. package/tests/acceptance/golden-product.test.ts +205 -0
  299. package/tests/acceptance/golden-product.ts +404 -0
  300. package/tests/acceptance/product/base-red.ts +73 -0
  301. package/tests/acceptance/product/documentation-examples.ts +68 -0
  302. package/tests/acceptance/product/intent-runtime.ts +145 -0
  303. package/tests/acceptance/product/release-output.ts +160 -0
  304. package/tests/acceptance/product/research-artifact.ts +87 -0
  305. package/tests/acceptance/product/research-revision.ts +82 -0
  306. package/tests/acceptance/product/research-source.ts +91 -0
  307. package/tests/acceptance/product/test-chain.ts +192 -0
  308. package/treeseed.package.yaml +147 -0
  309. package/dist/agent-capacity/allocation.d.ts +0 -186
  310. package/dist/agent-capacity/allocation.js +0 -226
  311. package/dist/agent-capacity/artifact-mutation-receipt.d.ts +0 -49
  312. package/dist/agent-capacity/artifact-mutation-receipt.js +0 -36
  313. package/dist/agent-capacity/artifacts.d.ts +0 -107
  314. package/dist/agent-capacity/artifacts.js +0 -39
  315. package/dist/agent-capacity/authority/agent-authority-presets.d.ts +0 -13
  316. package/dist/agent-capacity/authority/agent-authority-presets.js +0 -106
  317. package/dist/agent-capacity/contracts/operations/workflow-promotion.d.ts +0 -24
  318. package/dist/agent-capacity/contracts/support/decision-work.d.ts +0 -251
  319. package/dist/agent-capacity/policy/capacity/allocations/allocation-hierarchy.d.ts +0 -29
  320. package/dist/agent-capacity/policy/capacity/allocations/allocation-hierarchy.js +0 -110
  321. package/dist/agent-capacity/validation/allocation.d.ts +0 -12
  322. package/dist/agent-capacity/validation/allocation.js +0 -115
  323. package/dist/agent-capacity/validation/workflow-promotion.d.ts +0 -2
  324. package/dist/agent-capacity/validation/workflow-promotion.js +0 -34
  325. package/dist/operator-contracts/workday-profile.d.ts +0 -72
  326. package/dist/operator-contracts/workday-profile.js +0 -106
  327. package/dist/secrets-capability/service-vault-contracts.d.ts +0 -61
  328. package/dist/secrets-capability/service-vault-contracts.js +0 -39
  329. package/dist/treedx/accounts/auth.d.ts +0 -17
  330. package/dist/treedx/accounts/auth.js +0 -48
  331. package/dist/treedx/client/accounts/contracts/auth-mode.d.ts +0 -3
  332. package/dist/treedx/client/accounts/contracts/auth-mode.js +0 -6
  333. package/dist/treedx/client/build/creation/build-context.d.ts +0 -3
  334. package/dist/treedx/client/build/creation/build-context.js +0 -7
  335. package/dist/treedx/client/build/creation/build-snapshot.d.ts +0 -3
  336. package/dist/treedx/client/build/creation/build-snapshot.js +0 -8
  337. package/dist/treedx/client/capacity/allocations/contracts/put-capability-grant.d.ts +0 -3
  338. package/dist/treedx/client/capacity/allocations/contracts/put-capability-grant.js +0 -7
  339. package/dist/treedx/client/capacity/allocations/queries/list-capability-grants.d.ts +0 -6
  340. package/dist/treedx/client/capacity/allocations/queries/list-capability-grants.js +0 -10
  341. package/dist/treedx/client/methods.d.ts +0 -102
  342. package/dist/treedx/client/methods.js +0 -209
  343. package/dist/treedx/client/persistence/contracts/restore-storage.d.ts +0 -3
  344. package/dist/treedx/client/persistence/contracts/restore-storage.js +0 -6
  345. package/dist/treedx/client/persistence/lifecycle/verify-storage-restore.d.ts +0 -3
  346. package/dist/treedx/client/persistence/lifecycle/verify-storage-restore.js +0 -6
  347. package/dist/treedx/client/repositories/creation/register-repository.d.ts +0 -3
  348. package/dist/treedx/client/repositories/creation/register-repository.js +0 -7
  349. package/dist/treedx/client/repositories/queries/get-repository.d.ts +0 -3
  350. package/dist/treedx/client/repositories/queries/get-repository.js +0 -7
  351. package/dist/treedx/client/repositories/queries/list-repository-paths.d.ts +0 -3
  352. package/dist/treedx/client/repositories/queries/list-repository-paths.js +0 -7
  353. package/dist/treedx/client/repositories/queries/list-repository-refs.d.ts +0 -3
  354. package/dist/treedx/client/repositories/queries/list-repository-refs.js +0 -12
  355. package/dist/treedx/client/repositories/queries/query-repository.d.ts +0 -3
  356. package/dist/treedx/client/repositories/queries/query-repository.js +0 -7
  357. package/dist/treedx/client/repositories/queries/read-repository-file.d.ts +0 -3
  358. package/dist/treedx/client/repositories/queries/read-repository-file.js +0 -6
  359. package/dist/treedx/client/repositories/queries/read-repository-files.d.ts +0 -3
  360. package/dist/treedx/client/repositories/queries/read-repository-files.js +0 -7
  361. package/dist/treedx/client/repositories/queries/search-repository-files.d.ts +0 -3
  362. package/dist/treedx/client/repositories/queries/search-repository-files.js +0 -7
  363. package/dist/treedx/client/support/contracts/treedx/artifacts/contracts/download-artifact.d.ts +0 -3
  364. package/dist/treedx/client/support/contracts/treedx/artifacts/contracts/download-artifact.js +0 -9
  365. package/dist/treedx/client/support/contracts/treedx/authorization/contracts/whoami.d.ts +0 -3
  366. package/dist/treedx/client/support/contracts/treedx/authorization/contracts/whoami.js +0 -6
  367. package/dist/treedx/client/support/contracts/treedx/graph/contracts/parse-context-dsl.d.ts +0 -3
  368. package/dist/treedx/client/support/contracts/treedx/graph/contracts/parse-context-dsl.js +0 -7
  369. package/dist/treedx/client/support/contracts/treedx/health/contracts/deep-health.d.ts +0 -5
  370. package/dist/treedx/client/support/contracts/treedx/health/contracts/deep-health.js +0 -7
  371. package/dist/treedx/client/support/contracts/treedx/health/contracts/health.d.ts +0 -3
  372. package/dist/treedx/client/support/contracts/treedx/health/contracts/health.js +0 -6
  373. package/dist/treedx/client/support/contracts/treedx/health/contracts/metrics.d.ts +0 -3
  374. package/dist/treedx/client/support/contracts/treedx/health/contracts/metrics.js +0 -7
  375. package/dist/treedx/client/support/contracts/treedx/health/contracts/prometheus-metrics.d.ts +0 -2
  376. package/dist/treedx/client/support/contracts/treedx/health/contracts/prometheus-metrics.js +0 -19
  377. package/dist/treedx/client/support/contracts/treedx/health/contracts/ready.d.ts +0 -3
  378. package/dist/treedx/client/support/contracts/treedx/health/contracts/ready.js +0 -7
  379. package/dist/treedx/client/support/contracts/treedx/health/contracts/status.d.ts +0 -3
  380. package/dist/treedx/client/support/contracts/treedx/health/contracts/status.js +0 -6
  381. package/dist/treedx/client/support/contracts/treedx/repositories/contracts/commit.d.ts +0 -3
  382. package/dist/treedx/client/support/contracts/treedx/repositories/contracts/commit.js +0 -7
  383. package/dist/treedx/client/support/contracts/treedx/repositories/contracts/diff.d.ts +0 -3
  384. package/dist/treedx/client/support/contracts/treedx/repositories/contracts/diff.js +0 -6
  385. package/dist/treedx/client/support/contracts/treedx/repositories/contracts/fetch-remote.d.ts +0 -3
  386. package/dist/treedx/client/support/contracts/treedx/repositories/contracts/fetch-remote.js +0 -7
  387. package/dist/treedx/client/support/contracts/treedx/repositories/contracts/push.d.ts +0 -6
  388. package/dist/treedx/client/support/contracts/treedx/repositories/contracts/push.js +0 -23
  389. package/dist/treedx/client/support/contracts/treedx/search/contracts/compact-search-index.d.ts +0 -3
  390. package/dist/treedx/client/support/contracts/treedx/search/contracts/compact-search-index.js +0 -8
  391. package/dist/treedx/client/support/contracts/treedx/search/contracts/search.d.ts +0 -3
  392. package/dist/treedx/client/support/contracts/treedx/search/contracts/search.js +0 -7
  393. package/dist/treedx/client/support/contracts/treedx/storage/contracts/backup-storage.d.ts +0 -3
  394. package/dist/treedx/client/support/contracts/treedx/storage/contracts/backup-storage.js +0 -8
  395. package/dist/treedx/client/support/contracts/treedx/storage/contracts/compact-storage.d.ts +0 -3
  396. package/dist/treedx/client/support/contracts/treedx/storage/contracts/compact-storage.js +0 -8
  397. package/dist/treedx/client/support/contracts/treedx/transport/contracts/assert-binary-ok.d.ts +0 -2
  398. package/dist/treedx/client/support/contracts/treedx/transport/contracts/assert-binary-ok.js +0 -15
  399. package/dist/treedx/client/support/contracts/treedx/transport/contracts/fetch-with-timeout.d.ts +0 -2
  400. package/dist/treedx/client/support/contracts/treedx/transport/contracts/fetch-with-timeout.js +0 -38
  401. package/dist/treedx/client/support/contracts/treedx/transport/contracts/headers.d.ts +0 -2
  402. package/dist/treedx/client/support/contracts/treedx/transport/contracts/headers.js +0 -15
  403. package/dist/treedx/client/support/contracts/treedx/transport/contracts/parse-json-response.d.ts +0 -2
  404. package/dist/treedx/client/support/contracts/treedx/transport/contracts/parse-json-response.js +0 -15
  405. package/dist/treedx/client/support/contracts/treedx/transport/contracts/query.d.ts +0 -2
  406. package/dist/treedx/client/support/contracts/treedx/transport/contracts/query.js +0 -14
  407. package/dist/treedx/client/support/contracts/treedx/transport/contracts/repo-id.d.ts +0 -2
  408. package/dist/treedx/client/support/contracts/treedx/transport/contracts/repo-id.js +0 -14
  409. package/dist/treedx/client/support/contracts/treedx/transport/contracts/request.d.ts +0 -6
  410. package/dist/treedx/client/support/contracts/treedx/transport/contracts/request.js +0 -41
  411. package/dist/treedx/client/support/contracts/treedx/transport/contracts/throw-api-error.d.ts +0 -2
  412. package/dist/treedx/client/support/contracts/treedx/transport/contracts/throw-api-error.js +0 -14
  413. package/dist/treedx/client/support/contracts/treedx/workspaces/contracts/exec.d.ts +0 -3
  414. package/dist/treedx/client/support/contracts/treedx/workspaces/contracts/exec.js +0 -7
  415. package/dist/treedx/client/support/creation/apply-changeset.d.ts +0 -3
  416. package/dist/treedx/client/support/creation/apply-changeset.js +0 -10
  417. package/dist/treedx/client/support/creation/apply-storage-migration.d.ts +0 -3
  418. package/dist/treedx/client/support/creation/apply-storage-migration.js +0 -7
  419. package/dist/treedx/client/support/creation/create-migration.d.ts +0 -6
  420. package/dist/treedx/client/support/creation/create-migration.js +0 -7
  421. package/dist/treedx/client/support/creation/export-artifact.d.ts +0 -3
  422. package/dist/treedx/client/support/creation/export-artifact.js +0 -8
  423. package/dist/treedx/client/support/creation/plan-storage-migration.d.ts +0 -3
  424. package/dist/treedx/client/support/creation/plan-storage-migration.js +0 -7
  425. package/dist/treedx/client/support/creation/request-binary.d.ts +0 -6
  426. package/dist/treedx/client/support/creation/request-binary.js +0 -42
  427. package/dist/treedx/client/support/creation/write-file.d.ts +0 -3
  428. package/dist/treedx/client/support/creation/write-file.js +0 -10
  429. package/dist/treedx/client/support/creation/write-files.d.ts +0 -3
  430. package/dist/treedx/client/support/creation/write-files.js +0 -12
  431. package/dist/treedx/client/support/queries/treedx/artifacts/queries/get-artifact.d.ts +0 -3
  432. package/dist/treedx/client/support/queries/treedx/artifacts/queries/get-artifact.js +0 -7
  433. package/dist/treedx/client/support/queries/treedx/artifacts/queries/list-artifacts.d.ts +0 -3
  434. package/dist/treedx/client/support/queries/treedx/artifacts/queries/list-artifacts.js +0 -7
  435. package/dist/treedx/client/support/queries/treedx/authorization/queries/effective-scope.d.ts +0 -3
  436. package/dist/treedx/client/support/queries/treedx/authorization/queries/effective-scope.js +0 -9
  437. package/dist/treedx/client/support/queries/treedx/authorization/queries/list-capabilities.d.ts +0 -4
  438. package/dist/treedx/client/support/queries/treedx/authorization/queries/list-capabilities.js +0 -6
  439. package/dist/treedx/client/support/queries/treedx/federation/queries/get-placement.d.ts +0 -3
  440. package/dist/treedx/client/support/queries/treedx/federation/queries/get-placement.js +0 -7
  441. package/dist/treedx/client/support/queries/treedx/graph/queries/get-node.d.ts +0 -3
  442. package/dist/treedx/client/support/queries/treedx/graph/queries/get-node.js +0 -7
  443. package/dist/treedx/client/support/queries/treedx/graph/queries/get-related.d.ts +0 -3
  444. package/dist/treedx/client/support/queries/treedx/graph/queries/get-related.js +0 -7
  445. package/dist/treedx/client/support/queries/treedx/graph/queries/list-nodes.d.ts +0 -3
  446. package/dist/treedx/client/support/queries/treedx/graph/queries/list-nodes.js +0 -7
  447. package/dist/treedx/client/support/queries/treedx/repositories/queries/list-tree.d.ts +0 -3
  448. package/dist/treedx/client/support/queries/treedx/repositories/queries/list-tree.js +0 -10
  449. package/dist/treedx/client/support/queries/treedx/repositories/queries/read-file.d.ts +0 -3
  450. package/dist/treedx/client/support/queries/treedx/repositories/queries/read-file.js +0 -9
  451. package/dist/treedx/client/support/queries/treedx/search/queries/get-search-index-status.d.ts +0 -3
  452. package/dist/treedx/client/support/queries/treedx/search/queries/get-search-index-status.js +0 -7
  453. package/dist/treedx/client/support/queries/treedx/storage/queries/get-migration.d.ts +0 -6
  454. package/dist/treedx/client/support/queries/treedx/storage/queries/get-migration.js +0 -7
  455. package/dist/treedx/client/support/queries/treedx/storage/queries/get-snapshot.d.ts +0 -6
  456. package/dist/treedx/client/support/queries/treedx/storage/queries/get-snapshot.js +0 -7
  457. package/dist/treedx/client/support/queries/treedx/storage/queries/list-storage-migrations.d.ts +0 -6
  458. package/dist/treedx/client/support/queries/treedx/storage/queries/list-storage-migrations.js +0 -6
  459. package/dist/treedx/client/support/queries/treedx/transport/queries/list-audit-events.d.ts +0 -15
  460. package/dist/treedx/client/support/queries/treedx/transport/queries/list-audit-events.js +0 -6
  461. package/dist/treedx/client/support/queries/treedx/transport/queries/list-repositories.d.ts +0 -3
  462. package/dist/treedx/client/support/queries/treedx/transport/queries/list-repositories.js +0 -7
  463. package/dist/treedx/client/support/retirement/cleanup-artifacts.d.ts +0 -3
  464. package/dist/treedx/client/support/retirement/cleanup-artifacts.js +0 -7
  465. package/dist/treedx/client/support/retirement/delete-artifact.d.ts +0 -3
  466. package/dist/treedx/client/support/retirement/delete-artifact.js +0 -7
  467. package/dist/treedx/client/support/retirement/delete-file.d.ts +0 -3
  468. package/dist/treedx/client/support/retirement/delete-file.js +0 -10
  469. package/dist/treedx/client/support/retirement/rollback-storage-migration.d.ts +0 -3
  470. package/dist/treedx/client/support/retirement/rollback-storage-migration.js +0 -7
  471. package/dist/treedx/client/support/updates/patch-file.d.ts +0 -3
  472. package/dist/treedx/client/support/updates/patch-file.js +0 -10
  473. package/dist/treedx/client/support/updates/refresh-search-index.d.ts +0 -3
  474. package/dist/treedx/client/support/updates/refresh-search-index.js +0 -8
  475. package/dist/treedx/client/treedx/blobs/contracts/download-blob.d.ts +0 -3
  476. package/dist/treedx/client/treedx/blobs/contracts/download-blob.js +0 -6
  477. package/dist/treedx/client/treedx/blobs/creation/create-blob-upload.d.ts +0 -3
  478. package/dist/treedx/client/treedx/blobs/creation/create-blob-upload.js +0 -8
  479. package/dist/treedx/client/treedx/blobs/creation/request-blob-download.d.ts +0 -3
  480. package/dist/treedx/client/treedx/blobs/creation/request-blob-download.js +0 -27
  481. package/dist/treedx/client/treedx/blobs/creation/request-blob-upload.d.ts +0 -3
  482. package/dist/treedx/client/treedx/blobs/creation/request-blob-upload.js +0 -41
  483. package/dist/treedx/client/treedx/blobs/creation/upload-blob-part.d.ts +0 -3
  484. package/dist/treedx/client/treedx/blobs/creation/upload-blob-part.js +0 -27
  485. package/dist/treedx/client/treedx/blobs/creation/upload-blob.d.ts +0 -3
  486. package/dist/treedx/client/treedx/blobs/creation/upload-blob.js +0 -6
  487. package/dist/treedx/client/treedx/blobs/creation/write-blob.d.ts +0 -3
  488. package/dist/treedx/client/treedx/blobs/creation/write-blob.js +0 -8
  489. package/dist/treedx/client/treedx/blobs/lifecycle/complete-blob-upload.d.ts +0 -3
  490. package/dist/treedx/client/treedx/blobs/lifecycle/complete-blob-upload.js +0 -8
  491. package/dist/treedx/client/treedx/blobs/queries/read-blob.d.ts +0 -3
  492. package/dist/treedx/client/treedx/blobs/queries/read-blob.js +0 -10
  493. package/dist/treedx/client/treedx/blobs/retirement/abort-blob-upload.d.ts +0 -3
  494. package/dist/treedx/client/treedx/blobs/retirement/abort-blob-upload.js +0 -7
  495. package/dist/treedx/client/treedx/blobs/retirement/delete-blob.d.ts +0 -3
  496. package/dist/treedx/client/treedx/blobs/retirement/delete-blob.js +0 -8
  497. package/dist/treedx/client/treedx/federation/contracts/federated-query.d.ts +0 -3
  498. package/dist/treedx/client/treedx/federation/contracts/federated-query.js +0 -7
  499. package/dist/treedx/client/treedx/federation/creation/plan-federated-query.d.ts +0 -3
  500. package/dist/treedx/client/treedx/federation/creation/plan-federated-query.js +0 -6
  501. package/dist/treedx/client/treedx/federation/queries/check-mirror-health.d.ts +0 -3
  502. package/dist/treedx/client/treedx/federation/queries/check-mirror-health.js +0 -7
  503. package/dist/treedx/client/treedx/federation/updates/promote-mirror.d.ts +0 -3
  504. package/dist/treedx/client/treedx/federation/updates/promote-mirror.js +0 -7
  505. package/dist/treedx/client/treedx/federation/updates/sync-mirror.d.ts +0 -3
  506. package/dist/treedx/client/treedx/federation/updates/sync-mirror.js +0 -7
  507. package/dist/treedx/client/treedx/graph/contracts/federated-context.d.ts +0 -3
  508. package/dist/treedx/client/treedx/graph/contracts/federated-context.js +0 -7
  509. package/dist/treedx/client/treedx/graph/contracts/federated-graph.d.ts +0 -3
  510. package/dist/treedx/client/treedx/graph/contracts/federated-graph.js +0 -7
  511. package/dist/treedx/client/treedx/graph/contracts/graph-search.d.ts +0 -3
  512. package/dist/treedx/client/treedx/graph/contracts/graph-search.js +0 -8
  513. package/dist/treedx/client/treedx/graph/queries/get-graph-node.d.ts +0 -3
  514. package/dist/treedx/client/treedx/graph/queries/get-graph-node.js +0 -10
  515. package/dist/treedx/client/treedx/graph/queries/get-graph-refresh-job.d.ts +0 -3
  516. package/dist/treedx/client/treedx/graph/queries/get-graph-refresh-job.js +0 -7
  517. package/dist/treedx/client/treedx/graph/queries/get-subgraph.d.ts +0 -3
  518. package/dist/treedx/client/treedx/graph/queries/get-subgraph.js +0 -7
  519. package/dist/treedx/client/treedx/graph/queries/query-graph.d.ts +0 -3
  520. package/dist/treedx/client/treedx/graph/queries/query-graph.js +0 -7
  521. package/dist/treedx/client/treedx/graph/queries/search-graph-entities.d.ts +0 -3
  522. package/dist/treedx/client/treedx/graph/queries/search-graph-entities.js +0 -6
  523. package/dist/treedx/client/treedx/graph/queries/search-graph-files.d.ts +0 -3
  524. package/dist/treedx/client/treedx/graph/queries/search-graph-files.js +0 -6
  525. package/dist/treedx/client/treedx/graph/queries/search-graph-sections.d.ts +0 -3
  526. package/dist/treedx/client/treedx/graph/queries/search-graph-sections.js +0 -6
  527. package/dist/treedx/client/treedx/graph/updates/refresh-graph.d.ts +0 -3
  528. package/dist/treedx/client/treedx/graph/updates/refresh-graph.js +0 -7
  529. package/dist/treedx/client/treedx/search/contracts/federated-search.d.ts +0 -3
  530. package/dist/treedx/client/treedx/search/contracts/federated-search.js +0 -7
  531. package/dist/treedx/client/treedx/workspaces/creation/create-workspace.d.ts +0 -3
  532. package/dist/treedx/client/treedx/workspaces/creation/create-workspace.js +0 -7
  533. package/dist/treedx/client/treedx/workspaces/retirement/abandon-workspace.d.ts +0 -3
  534. package/dist/treedx/client/treedx/workspaces/retirement/abandon-workspace.js +0 -12
  535. package/dist/treedx/client/treedx/workspaces/retirement/close-workspace.d.ts +0 -2
  536. package/dist/treedx/client/treedx/workspaces/retirement/close-workspace.js +0 -6
  537. package/dist/treedx/generated/openapi-types.d.ts +0 -3662
  538. package/dist/treedx/generated/openapi-types.js +0 -0
  539. package/dist/treedx/support/client.d.ts +0 -251
  540. package/dist/treedx/support/client.js +0 -252
  541. package/dist/treedx/support/errors.d.ts +0 -13
  542. package/dist/treedx/support/errors.js +0 -17
  543. package/dist/treedx/types/tree-dx-actor.d.ts +0 -209
  544. package/dist/treedx/types/tree-dx-actor.js +0 -8
  545. package/dist/treedx/types/tree-dx-artifact-list-response.d.ts +0 -13
  546. package/dist/treedx/types/tree-dx-artifact-list-response.js +0 -0
  547. package/dist/treedx/types/tree-dx-changeset.d.ts +0 -51
  548. package/dist/treedx/types/tree-dx-changeset.js +0 -6
  549. package/dist/treedx/types/tree-dx-context-request.d.ts +0 -245
  550. package/dist/treedx/types/tree-dx-context-request.js +0 -0
  551. package/dist/treedx/types/tree-dx-exec-result.d.ts +0 -249
  552. package/dist/treedx/types/tree-dx-exec-result.js +0 -0
  553. package/dist/treedx/types/tree-dx-list-tree-request.d.ts +0 -222
  554. package/dist/treedx/types/tree-dx-list-tree-request.js +0 -0
  555. package/dist/treedx/types/tree-dx-push-request.d.ts +0 -229
  556. package/dist/treedx/types/tree-dx-push-request.js +0 -0
  557. /package/dist/{agent-capacity/contracts/operations/workflow-promotion.js → site-contracts/cloudflare.js} +0 -0
  558. /package/dist/{agent-capacity/contracts/support/decision-work.js → site-contracts/platform.js} +0 -0
@@ -0,0 +1,192 @@
1
+ import {verifySdkDocumentationExamples} from './documentation-examples.ts';
2
+ export {verifySdkDocumentationExamples} from './documentation-examples.ts';
3
+ import assert from 'node:assert/strict';
4
+ import { execFileSync } from 'node:child_process';
5
+ import { createHash } from 'node:crypto';
6
+ import { existsSync, lstatSync, realpathSync } from 'node:fs';
7
+ import { isAbsolute, join } from 'node:path';
8
+ import { assignmentReferenceSchema, type AssignmentAttempt, type AssignmentReference, type AssignmentResult } from '@treeseed/sdk/agent-capacity';
9
+ import { sourceWorkspaceKeySchema, sourceWorkspaceAuthorizationSchema } from '@treeseed/sdk/capacity-provider/sandbox';
10
+
11
+ export type PublishedSourceAttempt = Pick<AssignmentAttempt, 'id' | 'teamId' | 'projectId' | 'attempt' | 'workspace'>
12
+ & { provider: Pick<AssignmentAttempt['provider'], 'providerId'> };
13
+
14
+ const failure = 'ACCEPTANCE_SDK_NATIVE_TEST_CHAIN';
15
+ /** Join original reviewed predecessors; workspace compilation remains API-owned. */
16
+ export function verifySdkReviewedSourceInput(next: Pick<AssignmentAttempt, 'workspace' | 'predecessorResultIds' | 'createdAt'>,
17
+ predecessor: Pick<AssignmentResult, 'id'>, review: Pick<AssignmentResult, 'id' | 'completedAt'>, reference: AssignmentReference): void {
18
+ assert.ok(reference.kind === 'git', failure);
19
+ assert.ok(next.predecessorResultIds.includes(predecessor.id) && next.predecessorResultIds.includes(review.id), failure);
20
+ assert.ok(next.workspace.mode === 'git' && next.workspace.repository === reference.repository, failure);
21
+ assert.ok(Date.parse(review.completedAt) <= Date.parse(next.createdAt), failure);
22
+ }
23
+ const object = (value: unknown): Record<string, unknown> => {
24
+ assert.ok(value && typeof value === 'object' && !Array.isArray(value), failure);
25
+ return value as Record<string, unknown>;
26
+ };
27
+
28
+ /** The existing fixed public owning inventory supplies the locator, never an operator path. */
29
+ export function sdkPublishedRepository(workspace: unknown, sandboxId: string, attempt: PublishedSourceAttempt, reference: AssignmentReference) {
30
+ const observation = object(workspace), scope = object(observation.scope), journals = object(observation.journals);
31
+ assert.equal(observation.complete, true, failure); assert.deepEqual(observation.errors, [], failure);
32
+ assert.equal(scope.storageRoot, '/var/lib/treeseed/agent/workspaces', failure);
33
+ assert.match(sandboxId, /^sandbox-[A-Za-z0-9-]{1,128}$/u, failure);
34
+ assert.deepEqual(object(observation.confirmation).journals, journals, failure);
35
+ const entry = (kind: string) => {
36
+ const inventory = object(journals[kind]); assert.equal(inventory.rootPresent, true, failure);
37
+ assert.ok(Array.isArray(inventory.entries), failure);
38
+ const matches = inventory.entries.map(object).filter(item => item.name === `${sandboxId}.json`);
39
+ assert.equal(matches.length, 1, failure); const value = matches[0]!;
40
+ assert.equal(value.type, 'file', failure); assert.match(String(value.digest), /^[a-f0-9]{64}$/u, failure);
41
+ return object(value.metadata);
42
+ };
43
+ const job = entry('jobs'), result = entry('results');
44
+ assert.equal(job.schemaVersion, 'treeseed.assignment-source-job/v1', failure);
45
+ assert.deepEqual(job.owner, { assignmentId: attempt.id, providerId: attempt.provider.providerId,
46
+ teamId: attempt.teamId, projectId: attempt.projectId, attempt: attempt.attempt }, failure);
47
+ assert.equal(result.schemaVersion, 'treeseed.source-result/v1', failure);
48
+ assert.equal(result.sandboxId, sandboxId, failure); assert.equal(result.leaseId, job.leaseId, failure);
49
+ assert.ok(typeof result.leaseId === 'string' && result.leaseId.length > 0, failure);
50
+ assert.equal(result.status, 'completed', failure); assert.equal(result.teardownVerified, true, failure);
51
+ const source = sourceWorkspaceKeySchema.parse(result.source);
52
+ assert.equal(source.teamId, attempt.teamId, failure); assert.equal(source.projectId, attempt.projectId, failure);
53
+ assert.equal(attempt.workspace.mode, 'git', failure);
54
+ assert.ok(attempt.workspace.mode === 'git'); assert.equal(source.commit, attempt.workspace.baseCommit, failure);
55
+ assert.equal(reference.kind, 'git', failure); assert.deepEqual(assignmentReferenceSchema.parse(result.sourceReference), reference, failure);
56
+ assert.ok(reference.kind === 'git'); assert.equal(reference.repository, attempt.workspace.repository, failure);
57
+ assert.equal(reference.branch, attempt.workspace.branch, failure);
58
+ const parsedAuthority = sourceWorkspaceAuthorizationSchema.safeParse(job.authority); assert.ok(parsedAuthority.success, failure);
59
+ const authority = parsedAuthority.data; assert.deepEqual(authority, job.authority, failure);
60
+ assert.equal(authority.assignmentId, attempt.id, failure); assert.equal(authority.providerId, attempt.provider.providerId, failure);
61
+ assert.equal(authority.attempt, attempt.attempt, failure); assert.deepEqual(authority.source, source, failure);
62
+ assert.equal(authority.mode, 'work', failure); assert.equal(authority.publication, 'simulation-branch', failure);
63
+ assert.ok(['upstream-public', 'simulation-local'].includes(authority.acquisition), failure);
64
+ assert.equal(Object.hasOwn(authority, 'credentialBindingId'), false, failure);
65
+ assert.equal(authority.publicationRef, reference.branch, failure);
66
+
67
+ const candidate = entry('candidates'), verification = object(candidate.verification);
68
+ assert.equal(candidate.state, 'published', failure);
69
+ assert.equal(candidate.assignmentId, attempt.id, failure); assert.equal(candidate.attempt, attempt.attempt, failure);
70
+ assert.equal(candidate.providerId, attempt.provider.providerId, failure); assert.equal(candidate.leaseId, job.leaseId, failure);
71
+ const candidateSource = sourceWorkspaceKeySchema.safeParse(candidate.source); assert.ok(candidateSource.success, failure);
72
+ assert.deepEqual(candidateSource.data, candidate.source, failure); assert.deepEqual(candidateSource.data, source, failure);
73
+ assert.equal(candidate.commit, reference.commit, failure); assert.equal(verification.baseCommit, attempt.workspace.baseCommit, failure);
74
+ assert.equal(verification.commit, reference.commit, failure);
75
+ assert.deepEqual(Object.keys(verification).sort(), ['ancestry', 'baseCommit', 'bytes', 'clean', 'commit', 'isolatedVerifier', 'objectClosure'], failure);
76
+ assert.ok(Number.isSafeInteger(verification.bytes) && Number(verification.bytes) > 0, failure);
77
+ for (const flag of ['clean', 'objectClosure', 'ancestry', 'isolatedVerifier']) assert.equal(verification[flag], true, failure);
78
+ assert.ok(typeof candidate.verifierId === 'string' && /^sandbox-warm-[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/u.test(candidate.verifierId), failure);
79
+ assert.equal(candidate.verifierStopped, true, failure);
80
+ assert.ok(typeof candidate.digest === 'string' && /^sha256:[a-f0-9]{64}$/u.test(candidate.digest), failure);
81
+ const repository = result.simulationRepository;
82
+ assert.ok(typeof repository === 'string' && /^\/var\/lib\/treeseed\/agent\/workspaces\/simulations\/[a-f0-9]{64}\.git$/u.test(repository), failure);
83
+ return repository;
84
+ }
85
+
86
+ export function nativePublishedGit(repository: string) {
87
+ assert.ok(isAbsolute(repository), failure);
88
+ assert.equal(realpathSync(repository), repository, failure); assert.ok(lstatSync(repository).isDirectory(), failure);
89
+ assert.equal(existsSync(join(repository, 'objects/info/alternates')), false, failure);
90
+ assert.equal(existsSync(join(repository, 'shallow')), false, failure);
91
+ const git = (args: string[]) => execFileSync('/usr/bin/git', ['--no-replace-objects', `--git-dir=${repository}`,
92
+ '-c', 'core.hooksPath=/dev/null', ...args], { timeout: 5000, maxBuffer: 32 * 1024 * 1024,
93
+ env: { PATH: '/usr/bin:/bin', LANG: 'C', GIT_CONFIG_NOSYSTEM: '1', GIT_CONFIG_GLOBAL: '/dev/null' } });
94
+ assert.equal(git(['rev-parse', '--is-bare-repository']).toString().trim(), 'true', failure);
95
+ return git;
96
+ }
97
+
98
+ /** Resolve the original published assignment branch independently from its journal and result. */
99
+ export function verifySdkPublishedBranch(repository: string, reference: AssignmentReference) {
100
+ assert.equal(reference.kind, 'git', failure); assert.ok(reference.kind === 'git');
101
+ assert.ok(typeof reference.branch === 'string' && reference.branch.length > 0, failure);
102
+ assert.match(reference.commit, /^[a-f0-9]{40}$/u, failure);
103
+ const git = nativePublishedGit(repository), ref = `refs/heads/${reference.branch}`;
104
+ git(['check-ref-format', ref]);
105
+ assert.equal(git(['show-ref', '--verify', '--hash', ref]).toString().trim(), reference.commit, failure);
106
+ assert.equal(git(['rev-parse', '--verify', `${reference.commit}^{commit}`]).toString().trim(), reference.commit, failure);
107
+ assert.equal(git(['show-ref', '--verify', '--hash', ref]).toString().trim(), reference.commit, failure);
108
+ return reference.commit;
109
+ }
110
+
111
+ /** Inspect visible committed documentation, rather than metadata or comments alone. */
112
+ export function sdkDocumentationBody(bytes: Buffer): string {
113
+ const text = bytes.toString('utf8'); assert.deepEqual(Buffer.from(text), bytes, `${failure}: Documentation must be UTF-8`);
114
+ assert.ok(!text.includes('\0'), `${failure}: Binary documentation denied`);
115
+ return text.replace(/^---\r?\n[\s\S]*?\r?\n---(?:\r?\n|$)/u, '').replace(/<!--[\s\S]*?-->/gu, '').trim();
116
+ }
117
+
118
+ /** Independent native Git objects prove ancestry and exact approved test bytes. No product code is changed. */
119
+ export function verifySdkCommittedTests(repository: string, base: string, tester: string, engineer: string,
120
+ integration?: { writer: string; release: string; writerBase: string }) {
121
+ for (const commit of [base, tester, engineer]) assert.match(commit, /^[a-f0-9]{40}$/u, failure);
122
+ if (integration) {
123
+ for (const commit of [integration.writer, integration.release, integration.writerBase]) assert.ok(typeof commit === 'string' && /^[a-f0-9]{40}$/u.test(commit), failure);
124
+ assert.equal(integration.writerBase, engineer, `${failure}: Writer must start from the independently approved implementation`);
125
+ }
126
+ assert.equal(new Set([base, tester, engineer]).size, 3, failure);
127
+ const git = nativePublishedGit(repository);
128
+ for (const commit of [base, tester, engineer]) assert.equal(git(['rev-parse', '--verify', `${commit}^{commit}`]).toString().trim(), commit, failure);
129
+ git(['merge-base', '--is-ancestor', base, tester]); git(['merge-base', '--is-ancestor', tester, engineer]);
130
+ if (integration) {
131
+ for (const commit of [integration.writer, integration.release])
132
+ assert.equal(git(['rev-parse', '--verify', `${commit}^{commit}`]).toString().trim(), commit, failure);
133
+ git(['merge-base', '--is-ancestor', engineer, integration.writer]);
134
+ const changed = git(['diff', '--name-only', '--no-renames', '-z', engineer, integration.writer]).toString('utf8').split('\0').filter(Boolean);
135
+ assert.ok(changed.every(path => /^(?:[^/]+\.mdx?$|docs\/|examples\/)/u.test(path)),
136
+ `${failure}: Writer must preserve the independently approved implementation and test runner`);
137
+ const docs = changed.filter(path => /^(?:[^/]+\.mdx?|docs\/.+\.mdx?)$/u.test(path));
138
+ let documented = 0;
139
+ for (const path of docs) {
140
+ const entry = git(['ls-tree', '-z', integration.writer, '--', path]).toString('utf8');
141
+ if (!entry) continue; // Removed obsolete pages cannot count as the delivered documentation.
142
+ assert.ok(/^(100644|100755) blob [a-f0-9]{40}\t/u.test(entry), `${failure}: Writer deleted or redirected documentation`);
143
+ const body = sdkDocumentationBody(git(['cat-file', 'blob', `${integration.writer}:${path}`]));
144
+ assert.ok(body && /[\p{L}\p{N}]/u.test(body), `${failure}: Empty documentation is not a delivered product`);
145
+ const previous = git(['ls-tree', '-z', engineer, '--', path]);
146
+ if (previous.length && body === sdkDocumentationBody(git(['cat-file', 'blob', `${engineer}:${path}`]))) continue;
147
+ documented++;
148
+ }
149
+ assert.ok(documented > 0, `${failure}: Actual repository documentation must change`);
150
+
151
+ git(['merge-base', '--is-ancestor', integration.writer, integration.release]);
152
+ assert.equal(git(['rev-parse', `${integration.release}^{tree}`]).toString().trim(),
153
+ git(['rev-parse', `${integration.writer}^{tree}`]).toString().trim(), `${failure}: Integration contains unreviewed changes`);
154
+ }
155
+ const implementation = git(['diff', '--name-only', '--no-renames', '-z', tester, engineer]).toString('utf8').split('\0').filter(Boolean);
156
+ assert.ok(implementation.every(path => !path.startsWith('tests/') && !path.startsWith('scripts/')
157
+ && !['package.json', 'package-lock.json', 'npm-shrinkwrap.json', '.npmrc'].includes(path)
158
+ && !/^(?:vitest|vite|tsconfig)(?:\.[^/]+)?\.(?:ts|mts|cts|js|mjs|cjs|json)$/u.test(path)),
159
+ `${failure}: Engineer must retain every approved test and the original complete-suite runner`);
160
+ assert.ok(implementation.some(path => /^src\/.*\.ts$/u.test(path)
161
+ && /^100(?:644|755) blob [a-f0-9]{40}\t/u.test(git(['ls-tree', '-z', engineer, '--', path]).toString('utf8'))),
162
+ `${failure}: Engineer must produce a native source implementation after approved tests`);
163
+ const changed = git(['diff', '--name-only', '--no-renames', '-z', base, tester]).toString('utf8').split('\0').filter(Boolean);
164
+ assert.ok(changed.length > 0 && new Set(changed).size === changed.length, failure);
165
+ assert.ok(changed.every(path => /^tests\//u.test(path) && !path.split('/').some(part => part === '..' || part === '.' || part === '')), failure);
166
+ assert.ok(changed.some(path => /\.(?:test|spec)\.ts$/u.test(path)), failure);
167
+ const tests = changed.map(path => {
168
+ const original = git(['ls-tree', '-z', tester, '--', path]), consumed = git(['ls-tree', '-z', engineer, '--', path]);
169
+ assert.deepEqual(consumed, original, `${failure}: Engineer changed approved test ${path}`);
170
+ if (integration) for (const commit of [integration.writer, integration.release])
171
+ assert.deepEqual(git(['ls-tree', '-z', commit, '--', path]), original, `${failure}: Integrated candidate changed approved test ${path}`);
172
+ const match = /^(100644|100755) blob ([a-f0-9]{40})\t([^\0]+)\0$/u.exec(original.toString('utf8'));
173
+ assert.ok(match && match[3] === path, `${failure}: Tester deleted or redirected test ${path}`);
174
+ const blob = git(['cat-file', 'blob', `${tester}:${path}`]);
175
+ assert.deepEqual(git(['cat-file', 'blob', `${engineer}:${path}`]), blob, failure);
176
+ return { path, mode: match[1]!, objectId: match[2]!, digest: createHash('sha256').update(blob).digest('hex') };
177
+ });
178
+ for (const commit of [base, tester, engineer]) assert.equal(git(['rev-parse', '--verify', `${commit}^{commit}`]).toString().trim(), commit, failure);
179
+ return tests;
180
+ }
181
+
182
+ export {verifySdkBaseRed,verifySdkIntentRuntime} from './base-red.ts';
183
+
184
+ /** Resolve actual Writer documentation bytes from the independently published native Git repository. */
185
+ export function verifySdkReferenceDocumentation(repository:string,engineer:string,writer:string):void{
186
+ const label='ACCEPTANCE_SDK_DOCUMENTATION';for(const commit of [engineer,writer])assert.match(commit,/^[a-f0-9]{40}$/u,label);
187
+ const git=nativePublishedGit(repository);git(['merge-base','--is-ancestor',engineer,writer]);
188
+ const paths=git(['diff','--name-only','--no-renames','-z',engineer,writer]).toString('utf8').split('\0').filter(path=>/^(?:[^/]+\.mdx?|docs\/.+\.mdx?)$/u.test(path));
189
+ const documents:string[]=[];for(const path of paths){const entry=git(['ls-tree','-z',writer,'--',path]).toString('utf8');if(!entry)continue;assert.ok(/^100(?:644|755) blob [a-f0-9]{40}\t/u.test(entry),label+': Redirected reference page');documents.push(sdkDocumentationBody(git(['cat-file','blob',writer+':'+path])));}
190
+ verifySdkDocumentationExamples(documents);
191
+ assert.equal(git(['rev-parse',writer+'^{commit}']).toString().trim(),writer,label);
192
+ }
@@ -0,0 +1,147 @@
1
+ id: "@treeseed/sdk"
2
+ name: TreeSeed SDK
3
+ kind: node-typescript
4
+ type: node-library
5
+ repository: treeseed-ai/sdk
6
+ publishTarget: npm
7
+ capabilities: { save: true, verify: true, publish: true, deploy: false, localOnly: false }
8
+ workflowTemplateVersion: "1"
9
+ githubEnvironments:
10
+ - production
11
+ requiredSecrets:
12
+ - NPM_TOKEN
13
+ verify:
14
+ fast: npm run test:contracts
15
+ local: npm run verify:direct
16
+ release: npm run release:verify
17
+ artifacts:
18
+ - provider: npm
19
+ name: "@treeseed/sdk"
20
+ releaseGate:
21
+ workflow: verify.yml
22
+ development:
23
+ schemaVersion: treeseed.development-runtime/v1
24
+ project: { id: sdk, repository: treeseed-ai/sdk }
25
+ defaults: { leaseSeconds: 14400, restoreOnFailure: true }
26
+ targets:
27
+ - id: package
28
+ kind: package-watch
29
+ platforms: [linux-amd64, linux-arm64, darwin-arm64, darwin-amd64]
30
+ runtimeRequirements: [node>=22]
31
+ sourceRoots: [src, scripts/build, scripts/development]
32
+ ignoredPaths: [dist, node_modules]
33
+ operations:
34
+ watch: { command: node, args: [--watch-path=src, --watch-path=package.json, --import, tsx, scripts/development/build-watch.ts], environment: {}, timeoutSeconds: 86400 }
35
+ build: { command: node, args: [--import, tsx, scripts/development/build-watch.ts], environment: {}, timeoutSeconds: 900 }
36
+ verify: { command: npm, args: [run, test:contracts], environment: {}, timeoutSeconds: 900 }
37
+ ready: { kind: marker, path: dist/.treeseed-build-complete.json, timeoutSeconds: 120 }
38
+ outputs: [{ path: dist, mediaType: application/vnd.treeseed.node-package, completionMarker: dist/.treeseed-build-complete.json, digestAlgorithm: sha256 }]
39
+ endpoints: []
40
+ dependencies: []
41
+ statePolicy: stateless
42
+ migrationPolicy: none
43
+ secretRefs: {}
44
+ shutdown: { graceSeconds: 10, activeWorkPolicy: block }
45
+ resources: {}
46
+ logs: [.treeseed/development/package.log]
47
+ forbiddenOperations: [publish, production-tag]
48
+ freeze:
49
+ kind: npm-package
50
+ operation: { command: npm, args: [pack, --json], environment: {}, timeoutSeconds: 900 }
51
+ artifacts: [treeseed-sdk-*.tgz]
52
+ contractOperations:
53
+ - { command: npm, args: [run, standards:build], environment: {}, timeoutSeconds: 900 }
54
+ - { command: npm, args: [run, standards:compatibility], environment: {}, timeoutSeconds: 900 }
55
+ promotion: { liveAdmissible: false, candidateRequiresVerification: true }
56
+ standards:
57
+ schemaVersion: 1
58
+ workflow:
59
+ enabled: true
60
+ acceptedBaseline:
61
+ packageName: "@treeseed/sdk"
62
+ packageVersion: "0.12.62"
63
+ sourceCommit: "d12a97fdd3fdca1358895a7a64fa2012197b2942"
64
+ npmIntegrity: "sha512-wR5ukK2pqw0fUE9gJMYgJmIUlMTy4NoYKJrHEo6NAN/QFNrpru+9vilaS4kCPrcZQl/YAleuv962Z8c/pwwrBQ=="
65
+ artifactDigest: "sha256:9ccef82ccd452905e5a1733a5ced81d6d629b0c0f0d893cf19ea1a3ed53bc9f5"
66
+ openApiSourceDigest: "sha256:53b87f22ad3b3e4a24f4050f764e9f27081c3968130431909a366b16baa9bebd"
67
+ produced:
68
+ - id: "@treeseed/sdk/typescript-public-api"
69
+ family: typescript
70
+ version: "1.0.0"
71
+ semanticRange: "^1.0.0"
72
+ source: dist
73
+ artifact: .treeseed/standards/typescript-public-api.json
74
+ verifier: scripts/standards/compare-compatibility.ts
75
+ - id: "@treeseed/sdk/openapi"
76
+ family: openapi
77
+ version: "1.0.0"
78
+ semanticRange: "^1.0.0"
79
+ source: docs/api/openapi.json
80
+ artifact: .treeseed/standards/openapi.json
81
+ verifier: scripts/standards/compare-compatibility.ts
82
+ - id: "@treeseed/sdk/control-plane-catalog"
83
+ family: json-schema
84
+ version: "1.0.0"
85
+ semanticRange: "^1.0.0"
86
+ source: src/operator-contracts/control-plane-operations.ts
87
+ artifact: .treeseed/standards/control-plane-catalog.json
88
+ verifier: scripts/standards/compare-compatibility.ts
89
+ - id: "@treeseed/sdk/guarantee-verifier-contract"
90
+ family: behavioral
91
+ version: "1.0.0"
92
+ semanticRange: "^1.0.0"
93
+ source: src/guarantees
94
+ artifact: .treeseed/standards/guarantee-verifier-contract.json
95
+ verifier: runUiEvidenceTrustVerifier
96
+ - id: "@treeseed/sdk/mcp-catalog-input"
97
+ family: behavioral
98
+ version: "1.0.0"
99
+ semanticRange: "^1.0.0"
100
+ source: src/operator-contracts/mcp.ts
101
+ artifact: .treeseed/standards/mcp-catalog-input.json
102
+ verifier: scripts/standards/compare-compatibility.ts
103
+ - id: "@treeseed/sdk/treedx-service-contract"
104
+ family: behavioral
105
+ version: "1.0.0"
106
+ semanticRange: "^1.0.0"
107
+ source: src/treedx/contract.ts
108
+ artifact: .treeseed/standards/treedx-service-contract.json
109
+ verifier: scripts/standards/compare-compatibility.ts
110
+ - id: "@treeseed/sdk/treeai-service-contract"
111
+ family: behavioral
112
+ version: "1.0.0"
113
+ semanticRange: "^1.0.0"
114
+ source: src/treeai/contract.ts
115
+ artifact: .treeseed/standards/treeai-service-contract.json
116
+ verifier: scripts/standards/compare-compatibility.ts
117
+ consumed:
118
+ - id: "@treeseed/treeai/openapi"
119
+ family: openapi
120
+ version: "0.11.0-rc2"
121
+ semanticRange: "0.11.0-rc2"
122
+ source: contracts/services/treeai/treeai-contract-release.json
123
+ artifact: contracts/services/treeai-adoption.json
124
+ verifier: scripts/standards/build-contract-bundle.ts
125
+ - id: "@treeseed/treedx/openapi"
126
+ family: openapi
127
+ version: "0.11.0"
128
+ semanticRange: "0.11.0"
129
+ source: node_modules/@treeseed/treedx/openapi.yaml
130
+ artifact: contracts/services/treedx-adoption.json
131
+ verifier: scripts/standards/build-contract-bundle.ts
132
+ guarantees:
133
+ - deterministic-contract-bundle
134
+ - exact-artifact-and-source-binding
135
+ - semantic-version-sufficiency
136
+ - artifact-bound-guarantee-evidence
137
+ - authoritative-treedx-service-adoption
138
+ - authoritative-treeai-service-adoption
139
+ deprecations: []
140
+ runtimes:
141
+ - node>=22
142
+ rollbackOperations:
143
+ - remove-prerelease-dist-tag
144
+ - restore-accepted-composition
145
+ projectArchitecture:
146
+ topology: package_only
147
+ rootPath: .
@@ -1,186 +0,0 @@
1
- export type CapacityAllocationSetStatus = 'draft' | 'validated' | 'active' | 'superseded' | 'archived';
2
- export type CapacityAllocationScope = 'project' | 'agent-class' | 'mode';
3
- export type CapacityAllocationOverflow = 'deny' | 'approval-required' | 'borrow';
4
- export type CapacityGrantStatus = 'planned' | 'active' | 'paused' | 'revoked' | 'expired';
5
- export interface CapacityAllocationSlicePolicy {
6
- targetPercent: number;
7
- minPercent: number;
8
- maxPercent: number;
9
- hardCapPercent: number;
10
- }
11
- export interface CapacityAllocationSlice {
12
- id: string;
13
- scope: CapacityAllocationScope;
14
- targetId: string;
15
- parentSliceId?: string | null;
16
- policy: CapacityAllocationSlicePolicy;
17
- metadata?: Record<string, unknown>;
18
- }
19
- export interface CapacityReservePolicy {
20
- percent: number;
21
- overflow: CapacityAllocationOverflow;
22
- }
23
- export interface CapacityBorrowingRule {
24
- id: string;
25
- fromSliceId: string;
26
- toSliceId: string;
27
- maxPercent: number;
28
- requiresApproval: boolean;
29
- allocationPriorityBand: 'minimum' | 'target' | 'normal' | 'overflow';
30
- allocationPriorityScore: number;
31
- }
32
- export interface CapacityAllocationSetV2 {
33
- schemaVersion: 2;
34
- id: string;
35
- teamId: string;
36
- version: number;
37
- status: CapacityAllocationSetStatus;
38
- effectiveFrom: string;
39
- effectiveUntil?: string | null;
40
- reservePolicy: CapacityReservePolicy;
41
- slices: CapacityAllocationSlice[];
42
- borrowingRules: CapacityBorrowingRule[];
43
- createdById?: string | null;
44
- activatedAt?: string | null;
45
- supersededById?: string | null;
46
- metadata?: Record<string, unknown>;
47
- createdAt?: string;
48
- updatedAt?: string;
49
- }
50
- export interface CapacityGrantV2 {
51
- schemaVersion: 2;
52
- id: string;
53
- membershipId: string;
54
- teamId: string;
55
- providerId: string;
56
- projectId: string;
57
- environment: string;
58
- status: CapacityGrantStatus;
59
- executionProviderIds: string[];
60
- laneIds: string[];
61
- capabilities: string[];
62
- allowedModes: Array<'planning' | 'acting'>;
63
- dailyAgentSecondsLimit?: number | null;
64
- monthlyAgentSecondsLimit?: number | null;
65
- maxConcurrentAssignments?: number | null;
66
- budgetLimits?: {
67
- tokens?: number | null;
68
- cost?: {
69
- amount: number;
70
- currency: string;
71
- } | null;
72
- native?: Array<{
73
- unit: string;
74
- amount: number;
75
- }>;
76
- } | null;
77
- unmetered?: boolean;
78
- expiresAt?: string | null;
79
- metadata?: Record<string, unknown>;
80
- }
81
- export type CapacityAdmissionReasonCode = 'allowed' | 'membership_not_approved' | 'membership_id_mismatch' | 'membership_suspended' | 'membership_revoked' | 'membership_team_mismatch' | 'membership_provider_mismatch' | 'availability_session_not_open' | 'outside_availability_window' | 'missing_active_grant' | 'grant_membership_mismatch' | 'grant_team_mismatch' | 'grant_provider_mismatch' | 'grant_expired' | 'grant_project_mismatch' | 'grant_environment_mismatch' | 'grant_mode_denied' | 'grant_capability_missing' | 'grant_execution_provider_denied' | 'grant_lane_denied' | 'grant_time_exhausted' | 'grant_concurrency_exhausted' | 'workday_not_active' | 'workday_budget_exhausted' | 'allocation_set_not_active' | 'allocation_set_not_effective' | 'allocation_team_mismatch' | 'allocation_slice_missing' | 'allocation_hard_cap_exhausted' | 'allocation_borrowing_approval_required' | 'allocation_borrowing_denied' | 'provider_capacity_exhausted' | 'provider_capability_missing' | 'provider_local_limit_exhausted' | 'acting_decision_not_approved' | 'acting_readiness_not_ready' | 'acting_capacity_plan_not_accepted' | 'requested_seconds_invalid' | 'requested_budget_invalid' | 'grant_token_exhausted' | 'grant_cost_exhausted' | 'grant_native_exhausted' | 'provider_budget_exhausted';
82
- export interface CapacityAdmissionInput {
83
- now: string;
84
- request: {
85
- teamId: string;
86
- providerId: string;
87
- membershipId: string;
88
- projectId: string;
89
- environment: string;
90
- agentClassId: string;
91
- mode: 'planning' | 'acting';
92
- executionProviderId?: string | null;
93
- laneId?: string | null;
94
- requiredCapabilities: string[];
95
- requestedSeconds: number;
96
- budget?: import('./contracts/support/time-capacity.js').CapacityBudgetV2 | null;
97
- };
98
- membership: {
99
- id: string;
100
- teamId: string;
101
- providerId: string;
102
- status: 'approved' | 'suspended' | 'revoked';
103
- };
104
- availability: {
105
- status: 'open' | 'draining' | 'closed' | 'expired';
106
- availableFrom: string;
107
- availableUntil?: string | null;
108
- };
109
- grant?: CapacityGrantV2 | null;
110
- workday: {
111
- id: string;
112
- status: 'draft' | 'active' | 'paused' | 'completed' | 'cancelled';
113
- totalSeconds: number;
114
- committedSeconds: number;
115
- };
116
- allocationSet?: CapacityAllocationSetV2 | null;
117
- allocationSliceIds: string[];
118
- committedSecondsBySlice: Record<string, number>;
119
- committedBorrowedSecondsByRule?: Record<string, number>;
120
- reserveCommittedSeconds?: number;
121
- approvedBorrowingRuleIds?: string[];
122
- providerCapacity: {
123
- availableAgentSeconds: number;
124
- availableConcurrentAssignments: number;
125
- capabilities?: string[];
126
- availableTokens?: number | null;
127
- availableCost?: number | null;
128
- availableNative?: Record<string, number>;
129
- };
130
- providerLocalLimits: {
131
- availableAgentSeconds: number;
132
- availableConcurrentAssignments: number;
133
- availableTokens?: number | null;
134
- availableCost?: number | null;
135
- availableNative?: Record<string, number>;
136
- };
137
- grantCommitted: {
138
- dailyAgentSeconds: number;
139
- monthlyAgentSeconds: number;
140
- activeAssignments: number;
141
- tokens?: number;
142
- cost?: number;
143
- native?: Record<string, number>;
144
- };
145
- acting?: {
146
- decisionApproved: boolean;
147
- readinessReady: boolean;
148
- capacityPlanAccepted: boolean;
149
- };
150
- }
151
- export interface CapacityAdmissionDecision {
152
- allowed: boolean;
153
- reasonCode: CapacityAdmissionReasonCode;
154
- reasonCodes: CapacityAdmissionReasonCode[];
155
- maxReservableSeconds: number;
156
- requiresApproval: boolean;
157
- allocationPriorityBand: 'minimum' | 'target' | 'normal' | 'overflow';
158
- allocationPriorityScore: number;
159
- grantId?: string | null;
160
- allocationSetId?: string | null;
161
- allocationVersion?: number | null;
162
- counterClaims: CapacityAdmissionCounterClaim[];
163
- policySnapshot: Record<string, unknown>;
164
- explanation: Array<{
165
- gate: string;
166
- allowed: boolean;
167
- remaining?: number;
168
- detail?: string;
169
- }>;
170
- }
171
- export interface CapacityAdmissionCounterClaim {
172
- id: string;
173
- scope: 'grant-daily' | 'grant-monthly' | 'grant-concurrency' | 'grant-token' | 'grant-cost' | 'grant-native' | 'provider-time' | 'provider-concurrency' | 'provider-token' | 'provider-cost' | 'provider-native' | 'provider-local-time' | 'provider-local-concurrency' | 'provider-local-token' | 'provider-local-cost' | 'provider-local-native' | 'workday' | 'allocation-slice' | 'allocation-overflow' | 'allocation-reserve' | 'allocation-borrow';
174
- scopeId: string;
175
- periodKey: string;
176
- hardLimit: number;
177
- amount: number;
178
- release: 'settlement-difference' | 'assignment-terminal';
179
- dimension?: 'time' | 'concurrency' | 'tokens' | 'cost' | 'native';
180
- unit?: string | null;
181
- }
182
- export { validateCapacityAllocationSetV2, validateCapacityGrantV2 } from './validation/allocation.js';
183
- export type { CapacityAllocationDiagnostic, CapacityAllocationValidation } from './validation/allocation.js';
184
- export declare function timestamp(value: string | null | undefined): number | null;
185
- export declare function firstReason(reasons: CapacityAdmissionReasonCode[]): CapacityAdmissionReasonCode;
186
- export declare function evaluateCapacityAdmission(input: CapacityAdmissionInput): CapacityAdmissionDecision;