@claudexor/schema 1.0.1 → 2.1.1

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 (278) hide show
  1. package/dist/agent-capabilities.d.ts +102 -30
  2. package/dist/agent-capabilities.d.ts.map +1 -1
  3. package/dist/agent-capabilities.js +49 -18
  4. package/dist/agent-capabilities.js.map +1 -1
  5. package/dist/apply-eligibility.d.ts.map +1 -1
  6. package/dist/apply-eligibility.js +22 -6
  7. package/dist/apply-eligibility.js.map +1 -1
  8. package/dist/attachment.d.ts +117 -52
  9. package/dist/attachment.d.ts.map +1 -1
  10. package/dist/attachment.js +60 -45
  11. package/dist/attachment.js.map +1 -1
  12. package/dist/auth.d.ts +1444 -0
  13. package/dist/auth.d.ts.map +1 -0
  14. package/dist/auth.js +371 -0
  15. package/dist/auth.js.map +1 -0
  16. package/dist/budget.d.ts +147 -18
  17. package/dist/budget.d.ts.map +1 -1
  18. package/dist/budget.js +80 -22
  19. package/dist/budget.js.map +1 -1
  20. package/dist/config.d.ts +829 -135
  21. package/dist/config.d.ts.map +1 -1
  22. package/dist/config.js +195 -41
  23. package/dist/config.js.map +1 -1
  24. package/dist/context.d.ts +6 -6
  25. package/dist/context.d.ts.map +1 -1
  26. package/dist/context.js +31 -7
  27. package/dist/context.js.map +1 -1
  28. package/dist/control-gc.d.ts +185 -0
  29. package/dist/control-gc.d.ts.map +1 -0
  30. package/dist/control-gc.js +81 -0
  31. package/dist/control-gc.js.map +1 -0
  32. package/dist/control-operation-responses.d.ts +1298 -0
  33. package/dist/control-operation-responses.d.ts.map +1 -0
  34. package/dist/control-operation-responses.js +35 -0
  35. package/dist/control-operation-responses.js.map +1 -0
  36. package/dist/control-run-detail.d.ts +556 -247
  37. package/dist/control-run-detail.d.ts.map +1 -1
  38. package/dist/control-run-detail.js +72 -17
  39. package/dist/control-run-detail.js.map +1 -1
  40. package/dist/control-run-retry.d.ts +88 -0
  41. package/dist/control-run-retry.d.ts.map +1 -0
  42. package/dist/control-run-retry.js +40 -0
  43. package/dist/control-run-retry.js.map +1 -0
  44. package/dist/control-run-scope.d.ts +25 -0
  45. package/dist/control-run-scope.d.ts.map +1 -0
  46. package/dist/control-run-scope.js +22 -0
  47. package/dist/control-run-scope.js.map +1 -0
  48. package/dist/control-secret.d.ts +90 -0
  49. package/dist/control-secret.d.ts.map +1 -0
  50. package/dist/control-secret.js +35 -0
  51. package/dist/control-secret.js.map +1 -0
  52. package/dist/control-spec.d.ts +592 -0
  53. package/dist/control-spec.d.ts.map +1 -0
  54. package/dist/control-spec.js +85 -0
  55. package/dist/control-spec.js.map +1 -0
  56. package/dist/control-thread-apply.d.ts +175 -0
  57. package/dist/control-thread-apply.d.ts.map +1 -0
  58. package/dist/control-thread-apply.js +31 -0
  59. package/dist/control-thread-apply.js.map +1 -0
  60. package/dist/control-trust.d.ts +74 -10
  61. package/dist/control-trust.d.ts.map +1 -1
  62. package/dist/control-trust.js +31 -11
  63. package/dist/control-trust.js.map +1 -1
  64. package/dist/control.d.ts +1688 -1334
  65. package/dist/control.d.ts.map +1 -1
  66. package/dist/control.js +592 -333
  67. package/dist/control.js.map +1 -1
  68. package/dist/credential-profile.d.ts +454 -0
  69. package/dist/credential-profile.d.ts.map +1 -0
  70. package/dist/credential-profile.js +140 -0
  71. package/dist/credential-profile.js.map +1 -0
  72. package/dist/decision.d.ts +10 -10
  73. package/dist/decision.d.ts.map +1 -1
  74. package/dist/decision.js +62 -15
  75. package/dist/decision.js.map +1 -1
  76. package/dist/delivery.d.ts +99 -0
  77. package/dist/delivery.d.ts.map +1 -0
  78. package/dist/delivery.js +19 -0
  79. package/dist/delivery.js.map +1 -0
  80. package/dist/events.d.ts +41 -4
  81. package/dist/events.d.ts.map +1 -1
  82. package/dist/events.js +47 -4
  83. package/dist/events.js.map +1 -1
  84. package/dist/gate.d.ts +5 -5
  85. package/dist/gate.d.ts.map +1 -1
  86. package/dist/gate.js +25 -5
  87. package/dist/gate.js.map +1 -1
  88. package/dist/harness.d.ts +775 -237
  89. package/dist/harness.d.ts.map +1 -1
  90. package/dist/harness.js +314 -111
  91. package/dist/harness.js.map +1 -1
  92. package/dist/index.d.ts +19 -0
  93. package/dist/index.d.ts.map +1 -1
  94. package/dist/index.js +19 -0
  95. package/dist/index.js.map +1 -1
  96. package/dist/operation.d.ts +185 -0
  97. package/dist/operation.d.ts.map +1 -0
  98. package/dist/operation.js +50 -0
  99. package/dist/operation.js.map +1 -0
  100. package/dist/orchestrate.d.ts +150 -22
  101. package/dist/orchestrate.d.ts.map +1 -1
  102. package/dist/orchestrate.js +117 -7
  103. package/dist/orchestrate.js.map +1 -1
  104. package/dist/primitives.d.ts.map +1 -1
  105. package/dist/primitives.js +4 -1
  106. package/dist/primitives.js.map +1 -1
  107. package/dist/problem.d.ts +29 -0
  108. package/dist/problem.d.ts.map +1 -0
  109. package/dist/problem.js +17 -0
  110. package/dist/problem.js.map +1 -0
  111. package/dist/project.d.ts +97 -0
  112. package/dist/project.d.ts.map +1 -0
  113. package/dist/project.js +27 -0
  114. package/dist/project.js.map +1 -0
  115. package/dist/quota.d.ts +269 -0
  116. package/dist/quota.d.ts.map +1 -0
  117. package/dist/quota.js +58 -0
  118. package/dist/quota.js.map +1 -0
  119. package/dist/raw.d.ts +195 -0
  120. package/dist/raw.d.ts.map +1 -0
  121. package/dist/raw.js +58 -0
  122. package/dist/raw.js.map +1 -0
  123. package/dist/readiness.d.ts +596 -0
  124. package/dist/readiness.d.ts.map +1 -0
  125. package/dist/readiness.js +87 -0
  126. package/dist/readiness.js.map +1 -0
  127. package/dist/recovery.d.ts +515 -0
  128. package/dist/recovery.d.ts.map +1 -0
  129. package/dist/recovery.js +93 -0
  130. package/dist/recovery.js.map +1 -0
  131. package/dist/request-requirements.d.ts +36 -0
  132. package/dist/request-requirements.d.ts.map +1 -0
  133. package/dist/request-requirements.js +29 -0
  134. package/dist/request-requirements.js.map +1 -0
  135. package/dist/review.d.ts +26 -26
  136. package/dist/review.d.ts.map +1 -1
  137. package/dist/review.js +50 -10
  138. package/dist/review.js.map +1 -1
  139. package/dist/route.d.ts +13 -13
  140. package/dist/route.d.ts.map +1 -1
  141. package/dist/route.js +19 -4
  142. package/dist/route.js.map +1 -1
  143. package/dist/setup.d.ts +9811 -0
  144. package/dist/setup.d.ts.map +1 -0
  145. package/dist/setup.js +475 -0
  146. package/dist/setup.js.map +1 -0
  147. package/dist/spec.d.ts +178 -61
  148. package/dist/spec.d.ts.map +1 -1
  149. package/dist/spec.js +69 -16
  150. package/dist/spec.js.map +1 -1
  151. package/dist/surface-run-controls.d.ts.map +1 -1
  152. package/dist/surface-run-controls.js +25 -21
  153. package/dist/surface-run-controls.js.map +1 -1
  154. package/dist/task.d.ts +1657 -60
  155. package/dist/task.d.ts.map +1 -1
  156. package/dist/task.js +144 -18
  157. package/dist/task.js.map +1 -1
  158. package/dist/telemetry.d.ts +487 -72
  159. package/dist/telemetry.d.ts.map +1 -1
  160. package/dist/telemetry.js +194 -16
  161. package/dist/telemetry.js.map +1 -1
  162. package/dist/thread.d.ts +89 -51
  163. package/dist/thread.d.ts.map +1 -1
  164. package/dist/thread.js +56 -11
  165. package/dist/thread.js.map +1 -1
  166. package/dist/tool-ref.d.ts +45 -0
  167. package/dist/tool-ref.d.ts.map +1 -0
  168. package/dist/tool-ref.js +45 -0
  169. package/dist/tool-ref.js.map +1 -0
  170. package/dist/workproduct.d.ts +3 -3
  171. package/dist/workproduct.d.ts.map +1 -1
  172. package/dist/workproduct.js.map +1 -1
  173. package/dist/workspace.d.ts +3 -3
  174. package/dist/workspace.d.ts.map +1 -1
  175. package/dist/workspace.js +12 -3
  176. package/dist/workspace.js.map +1 -1
  177. package/generated/AgentCapabilityCatalog.schema.json +53 -11
  178. package/generated/BudgetLease.schema.json +55 -6
  179. package/generated/BudgetObservation.schema.json +44 -7
  180. package/generated/ConformanceReport.schema.json +49 -0
  181. package/generated/ControlApplyCheckResponse.schema.json +34 -0
  182. package/generated/ControlArtifactListResponse.schema.json +57 -0
  183. package/generated/ControlAuthReadinessRefreshRequest.schema.json +38 -0
  184. package/generated/ControlAuthReadinessRefreshResponse.schema.json +85 -0
  185. package/generated/ControlCredentialProfileCreateRequest.schema.json +32 -0
  186. package/generated/ControlCredentialProfileCreateResponse.schema.json +142 -0
  187. package/generated/ControlCredentialProfileDeleteResponse.schema.json +107 -0
  188. package/generated/ControlCredentialProfilesResponse.schema.json +155 -0
  189. package/generated/ControlDeliveryResponse.schema.json +136 -0
  190. package/generated/ControlGcReceipt.schema.json +170 -0
  191. package/generated/ControlGcRequest.schema.json +18 -0
  192. package/generated/ControlHandshakeRequest.schema.json +26 -0
  193. package/generated/ControlHandshakeResponse.schema.json +30 -0
  194. package/generated/ControlHarnessListResponse.schema.json +198 -14
  195. package/generated/ControlHarnessModelsResponse.schema.json +19 -0
  196. package/generated/ControlHarnessSettingsPatch.schema.json +9 -12
  197. package/generated/ControlJournalEvent.schema.json +42 -0
  198. package/generated/ControlJournalExportReceipt.schema.json +49 -0
  199. package/generated/ControlJournalInspection.schema.json +149 -0
  200. package/generated/ControlJournalQuarantineReceipt.schema.json +55 -0
  201. package/generated/ControlJournalQuarantineRequest.schema.json +24 -0
  202. package/generated/ControlJournalValidation.schema.json +181 -0
  203. package/generated/ControlOperationCatalog.schema.json +128 -0
  204. package/generated/ControlOperationDescriptor.schema.json +110 -0
  205. package/generated/ControlProblem.schema.json +59 -0
  206. package/generated/ControlProject.schema.json +42 -0
  207. package/generated/ControlProjectListResponse.schema.json +54 -0
  208. package/generated/ControlProjectRegisterRequest.schema.json +19 -0
  209. package/generated/ControlProjectRelinkRequest.schema.json +19 -0
  210. package/generated/ControlQueuedRunInfo.schema.json +4 -2
  211. package/generated/ControlQuotaResponse.schema.json +177 -0
  212. package/generated/ControlResource.schema.json +59 -0
  213. package/generated/ControlRunAgainDraft.schema.json +539 -0
  214. package/generated/ControlRunDetail.schema.json +373 -34
  215. package/generated/ControlRunListResponse.schema.json +968 -0
  216. package/generated/ControlRunRetryResponse.schema.json +54 -0
  217. package/generated/ControlRunStartRequest.schema.json +123 -55
  218. package/generated/ControlRunStartResponse.schema.json +78 -0
  219. package/generated/ControlRunSummary.schema.json +312 -21
  220. package/generated/ControlSecretListResponse.schema.json +8 -14
  221. package/generated/ControlSecretMutationResponse.schema.json +32 -0
  222. package/generated/ControlSecretSetRequest.schema.json +27 -0
  223. package/generated/ControlSettingsSnapshot.schema.json +128 -44
  224. package/generated/ControlSettingsUpdateRequest.schema.json +119 -40
  225. package/generated/ControlSetupJob.schema.json +770 -64
  226. package/generated/ControlSetupJobCreateRequest.schema.json +16 -13
  227. package/generated/ControlSetupJobEvent.schema.json +869 -5
  228. package/generated/ControlSetupJobListFilter.schema.json +35 -0
  229. package/generated/ControlSetupJobListResponse.schema.json +770 -64
  230. package/generated/ControlSetupJobSnapshot.schema.json +878 -0
  231. package/generated/ControlSpecAnswersRequest.schema.json +74 -0
  232. package/generated/ControlSpecQuestionsRequest.schema.json +128 -2
  233. package/generated/ControlSpecSession.schema.json +249 -0
  234. package/generated/ControlSpecSessionListResponse.schema.json +261 -0
  235. package/generated/ControlThread.schema.json +36 -6
  236. package/generated/ControlThreadApplyResponse.schema.json +139 -0
  237. package/generated/ControlThreadCreateRequest.schema.json +6 -2
  238. package/generated/ControlThreadDetail.schema.json +64 -12
  239. package/generated/ControlThreadListResponse.schema.json +36 -6
  240. package/generated/ControlThreadTurnRequest.schema.json +413 -0
  241. package/generated/ControlThreadTurnResponse.schema.json +73 -0
  242. package/generated/ControlThreadUpdateRequest.schema.json +12 -1
  243. package/generated/ControlTrustListResponse.schema.json +6 -0
  244. package/generated/ControlTrustState.schema.json +6 -0
  245. package/generated/ControlTrustUpdateRequest.schema.json +65 -3
  246. package/generated/ControlUploadCreateRequest.schema.json +37 -0
  247. package/generated/ControlUploadFinalizeRequest.schema.json +17 -0
  248. package/generated/ControlUploadStatus.schema.json +40 -0
  249. package/generated/CredentialProfile.schema.json +78 -0
  250. package/generated/CredentialProfileStatus.schema.json +61 -0
  251. package/generated/DecisionRecord.schema.json +6 -3
  252. package/generated/GlobalConfig.schema.json +238 -55
  253. package/generated/HarnessEvent.schema.json +259 -11
  254. package/generated/HarnessManifest.schema.json +96 -14
  255. package/generated/HarnessModel.schema.json +19 -0
  256. package/generated/HarnessStatusDto.schema.json +198 -14
  257. package/generated/OrchestrateContract.schema.json +32 -6
  258. package/generated/OrchestratePlan.schema.json +20 -0
  259. package/generated/OrchestratePlanProgress.schema.json +61 -0
  260. package/generated/PaidBudget.schema.json +42 -0
  261. package/generated/Project.schema.json +45 -0
  262. package/generated/ProjectConfig.schema.json +45 -18
  263. package/generated/RawContextPacket.schema.json +184 -0
  264. package/generated/RawGitPatchEnvelope.schema.json +70 -0
  265. package/generated/RunEvent.schema.json +3 -0
  266. package/generated/RunTelemetry.schema.json +280 -0
  267. package/generated/SecretMetadata.schema.json +4 -7
  268. package/generated/Session.schema.json +14 -0
  269. package/generated/SpecPack.schema.json +118 -7
  270. package/generated/TaskContract.schema.json +224 -30
  271. package/generated/TestCommandInvocation.schema.json +45 -0
  272. package/generated/Thread.schema.json +74 -6
  273. package/generated/ThreadHeadPing.schema.json +40 -0
  274. package/generated/ThreadTurn.schema.json +24 -11
  275. package/generated/TrustConfig.schema.json +77 -0
  276. package/package.json +3 -2
  277. package/generated/ControlSetupJobConfirmRequest.schema.json +0 -18
  278. package/generated/ControlSpecFreezeRequest.schema.json +0 -83
@@ -0,0 +1,155 @@
1
+ {
2
+ "$ref": "#/definitions/ControlCredentialProfilesResponse",
3
+ "definitions": {
4
+ "ControlCredentialProfilesResponse": {
5
+ "type": "object",
6
+ "properties": {
7
+ "profiles": {
8
+ "type": "array",
9
+ "items": {
10
+ "type": "object",
11
+ "properties": {
12
+ "profile": {
13
+ "type": "object",
14
+ "properties": {
15
+ "profile_id": {
16
+ "type": "string",
17
+ "minLength": 1,
18
+ "description": "Stable user-chosen profile identifier (unique per harness)."
19
+ },
20
+ "harness_id": {
21
+ "type": "string",
22
+ "minLength": 1,
23
+ "description": "Harness family this profile belongs to."
24
+ },
25
+ "display_name": {
26
+ "type": "string",
27
+ "minLength": 1,
28
+ "description": "Human label shown wherever the profile appears."
29
+ },
30
+ "credential_kind": {
31
+ "type": "string",
32
+ "enum": [
33
+ "config_dir_login",
34
+ "oauth_token",
35
+ "api_key"
36
+ ],
37
+ "description": "Credential transport a profile isolates: a scoped vendor config-dir login, a stored OAuth token, or a stored API key."
38
+ },
39
+ "isolation_locator": {
40
+ "type": [
41
+ "string",
42
+ "null"
43
+ ],
44
+ "default": null,
45
+ "description": "Canonical absolute config-dir path for config_dir_login profiles; null for secret-ref kinds."
46
+ },
47
+ "secret_ref": {
48
+ "type": [
49
+ "string",
50
+ "null"
51
+ ],
52
+ "default": null,
53
+ "description": "Namespaced secret-store name (e.g. claude_oauth:work) for oauth_token/api_key profiles; null for config_dir_login."
54
+ },
55
+ "enabled": {
56
+ "type": "boolean",
57
+ "default": true,
58
+ "description": "Disabled profiles are never routable."
59
+ },
60
+ "created_at": {
61
+ "anyOf": [
62
+ {
63
+ "type": "string",
64
+ "minLength": 1,
65
+ "description": "ISO-8601 timestamp string."
66
+ },
67
+ {
68
+ "type": "null"
69
+ }
70
+ ],
71
+ "description": "When the profile was registered; null for hand-written config entries.",
72
+ "default": null
73
+ }
74
+ },
75
+ "required": [
76
+ "profile_id",
77
+ "harness_id",
78
+ "display_name",
79
+ "credential_kind"
80
+ ],
81
+ "additionalProperties": false,
82
+ "description": "Durable non-secret registry entry for one credential identity of one harness; secret material lives in the vendor dir or the secret store, never here."
83
+ },
84
+ "status": {
85
+ "type": "object",
86
+ "properties": {
87
+ "profile_id": {
88
+ "type": "string",
89
+ "minLength": 1,
90
+ "description": "Non-empty identifier string."
91
+ },
92
+ "harness_id": {
93
+ "$ref": "#/definitions/ControlCredentialProfilesResponse/properties/profiles/items/properties/status/properties/profile_id"
94
+ },
95
+ "availability": {
96
+ "type": "string",
97
+ "enum": [
98
+ "available",
99
+ "unavailable",
100
+ "unknown"
101
+ ]
102
+ },
103
+ "verification": {
104
+ "type": "string",
105
+ "enum": [
106
+ "passed",
107
+ "failed",
108
+ "not_run"
109
+ ]
110
+ },
111
+ "detail": {
112
+ "type": "string",
113
+ "description": "Redacted human-readable probe evidence."
114
+ },
115
+ "last_verified_at": {
116
+ "anyOf": [
117
+ {
118
+ "$ref": "#/definitions/ControlCredentialProfilesResponse/properties/profiles/items/properties/profile/properties/created_at/anyOf/0"
119
+ },
120
+ {
121
+ "type": "null"
122
+ }
123
+ ],
124
+ "description": "When a probe last verified this profile; null = never verified.",
125
+ "default": null
126
+ }
127
+ },
128
+ "required": [
129
+ "profile_id",
130
+ "harness_id",
131
+ "availability",
132
+ "verification"
133
+ ],
134
+ "additionalProperties": false,
135
+ "description": "Doctor-owned readiness projection for one credential profile; never durable config."
136
+ }
137
+ },
138
+ "required": [
139
+ "profile",
140
+ "status"
141
+ ],
142
+ "additionalProperties": false
143
+ },
144
+ "description": "Every registered credential profile paired with its doctor readiness projection."
145
+ }
146
+ },
147
+ "required": [
148
+ "profiles"
149
+ ],
150
+ "additionalProperties": false,
151
+ "description": "Credential-profile registry listing with per-profile doctor readiness."
152
+ }
153
+ },
154
+ "$schema": "http://json-schema.org/draft-07/schema#"
155
+ }
@@ -0,0 +1,136 @@
1
+ {
2
+ "$ref": "#/definitions/ControlDeliveryResponse",
3
+ "definitions": {
4
+ "ControlDeliveryResponse": {
5
+ "type": "object",
6
+ "properties": {
7
+ "mode": {
8
+ "type": "string",
9
+ "enum": [
10
+ "artifact_only",
11
+ "apply",
12
+ "branch",
13
+ "commit",
14
+ "pr"
15
+ ]
16
+ },
17
+ "applied": {
18
+ "type": "boolean"
19
+ },
20
+ "branch": {
21
+ "type": "string"
22
+ },
23
+ "commit": {
24
+ "type": "string"
25
+ },
26
+ "prUrl": {
27
+ "type": "string"
28
+ },
29
+ "detail": {
30
+ "type": "string"
31
+ },
32
+ "treeMutated": {
33
+ "type": "boolean"
34
+ },
35
+ "refused": {
36
+ "type": "boolean"
37
+ },
38
+ "finalVerify": {
39
+ "type": "object",
40
+ "properties": {
41
+ "attempted": {
42
+ "type": "boolean",
43
+ "description": "Whether the final verify was attempted."
44
+ },
45
+ "base_sha": {
46
+ "type": [
47
+ "string",
48
+ "null"
49
+ ],
50
+ "default": null,
51
+ "description": "Base SHA the verify tree was created from (the winner envelope's base)."
52
+ },
53
+ "applied_cleanly": {
54
+ "type": [
55
+ "boolean",
56
+ "null"
57
+ ],
58
+ "default": null,
59
+ "description": "Whether the patch applied cleanly onto the fresh tree; null when not attempted."
60
+ },
61
+ "gates_passed": {
62
+ "type": [
63
+ "boolean",
64
+ "null"
65
+ ],
66
+ "default": null,
67
+ "description": "Whether the re-run deterministic gates passed; null when not attempted."
68
+ },
69
+ "gates": {
70
+ "type": "array",
71
+ "items": {
72
+ "type": "object",
73
+ "properties": {
74
+ "id": {
75
+ "type": "string",
76
+ "description": "Gate id."
77
+ },
78
+ "status": {
79
+ "type": "string",
80
+ "description": "Gate status."
81
+ }
82
+ },
83
+ "required": [
84
+ "id",
85
+ "status"
86
+ ],
87
+ "additionalProperties": false
88
+ },
89
+ "default": [],
90
+ "description": "Per-gate re-run results."
91
+ },
92
+ "duration_ms": {
93
+ "anyOf": [
94
+ {
95
+ "type": "integer",
96
+ "minimum": 0
97
+ },
98
+ {
99
+ "type": "null"
100
+ }
101
+ ],
102
+ "default": null,
103
+ "description": "How long the verify took, in milliseconds."
104
+ },
105
+ "reason": {
106
+ "type": [
107
+ "string",
108
+ "null"
109
+ ],
110
+ "default": null,
111
+ "description": "Typed reason when attempted=false (e.g. no_patch, no_base_sha) or a failure detail."
112
+ }
113
+ },
114
+ "required": [
115
+ "attempted"
116
+ ],
117
+ "additionalProperties": false,
118
+ "description": "Fresh verifier evidence for this delivery attempt."
119
+ },
120
+ "targetPreimageSha": {
121
+ "type": "string",
122
+ "description": "Target snapshot verified immediately before delivery."
123
+ }
124
+ },
125
+ "required": [
126
+ "mode",
127
+ "applied",
128
+ "finalVerify",
129
+ "targetPreimageSha"
130
+ ],
131
+ "additionalProperties": false,
132
+ "description": "Result of a manual run delivery attempt."
133
+ }
134
+ },
135
+ "$schema": "http://json-schema.org/draft-07/schema#"
136
+ }
@@ -0,0 +1,170 @@
1
+ {
2
+ "$ref": "#/definitions/ControlGcReceipt",
3
+ "definitions": {
4
+ "ControlGcReceipt": {
5
+ "type": "object",
6
+ "properties": {
7
+ "schema_version": {
8
+ "type": "number",
9
+ "const": 1,
10
+ "default": 1
11
+ },
12
+ "dry_run": {
13
+ "type": "boolean",
14
+ "description": "Whether disk was left untouched."
15
+ },
16
+ "started_at": {
17
+ "type": "string",
18
+ "description": "Pass start (ISO 8601)."
19
+ },
20
+ "finished_at": {
21
+ "type": "string",
22
+ "description": "Pass end (ISO 8601)."
23
+ },
24
+ "policy": {
25
+ "type": "object",
26
+ "properties": {
27
+ "runs_max_age_days": {
28
+ "type": "integer",
29
+ "exclusiveMinimum": 0
30
+ },
31
+ "reviews_max_age_days": {
32
+ "type": "integer",
33
+ "exclusiveMinimum": 0
34
+ },
35
+ "keep_last_runs_per_project": {
36
+ "type": "integer",
37
+ "minimum": 0
38
+ }
39
+ },
40
+ "required": [
41
+ "runs_max_age_days",
42
+ "reviews_max_age_days",
43
+ "keep_last_runs_per_project"
44
+ ],
45
+ "additionalProperties": false,
46
+ "description": "The effective retention policy this pass applied."
47
+ },
48
+ "examined_runs": {
49
+ "type": "integer",
50
+ "minimum": 0,
51
+ "description": "Run trees examined."
52
+ },
53
+ "deleted_runs": {
54
+ "type": "array",
55
+ "items": {
56
+ "type": "object",
57
+ "properties": {
58
+ "run_id": {
59
+ "type": "string",
60
+ "description": "Deleted (or would-be-deleted) run id."
61
+ },
62
+ "project_root": {
63
+ "type": "string",
64
+ "description": "Canonical project root owning the run tree."
65
+ },
66
+ "freed_bytes": {
67
+ "type": "integer",
68
+ "minimum": 0,
69
+ "description": "Bytes the tree occupied."
70
+ }
71
+ },
72
+ "required": [
73
+ "run_id",
74
+ "project_root",
75
+ "freed_bytes"
76
+ ],
77
+ "additionalProperties": false
78
+ },
79
+ "default": [],
80
+ "description": "Run trees deleted (or would-be under dry_run), tombstones left behind."
81
+ },
82
+ "kept": {
83
+ "type": "object",
84
+ "properties": {
85
+ "active": {
86
+ "type": "integer",
87
+ "minimum": 0,
88
+ "default": 0
89
+ },
90
+ "recent": {
91
+ "type": "integer",
92
+ "minimum": 0,
93
+ "default": 0
94
+ },
95
+ "young": {
96
+ "type": "integer",
97
+ "minimum": 0,
98
+ "default": 0
99
+ },
100
+ "referenced": {
101
+ "type": "integer",
102
+ "minimum": 0,
103
+ "default": 0
104
+ },
105
+ "actionable": {
106
+ "type": "integer",
107
+ "minimum": 0,
108
+ "default": 0
109
+ },
110
+ "unknown_state": {
111
+ "type": "integer",
112
+ "minimum": 0,
113
+ "default": 0
114
+ }
115
+ },
116
+ "additionalProperties": false,
117
+ "description": "Why every surviving candidate survived."
118
+ },
119
+ "deleted_reviews": {
120
+ "type": "array",
121
+ "items": {
122
+ "type": "object",
123
+ "properties": {
124
+ "path": {
125
+ "type": "string",
126
+ "description": "Deleted standalone diff-review tree."
127
+ },
128
+ "freed_bytes": {
129
+ "type": "integer",
130
+ "minimum": 0
131
+ }
132
+ },
133
+ "required": [
134
+ "path",
135
+ "freed_bytes"
136
+ ],
137
+ "additionalProperties": false
138
+ },
139
+ "default": [],
140
+ "description": "Standalone diff-review trees deleted (or would-be under dry_run)."
141
+ },
142
+ "freed_bytes": {
143
+ "type": "integer",
144
+ "minimum": 0,
145
+ "description": "Total bytes freed (or reclaimable under dry_run)."
146
+ },
147
+ "errors": {
148
+ "type": "array",
149
+ "items": {
150
+ "type": "string"
151
+ },
152
+ "default": [],
153
+ "description": "Non-fatal per-tree failures; the pass continues past them."
154
+ }
155
+ },
156
+ "required": [
157
+ "dry_run",
158
+ "started_at",
159
+ "finished_at",
160
+ "policy",
161
+ "examined_runs",
162
+ "kept",
163
+ "freed_bytes"
164
+ ],
165
+ "additionalProperties": false,
166
+ "description": "Typed receipt of one retention pass."
167
+ }
168
+ },
169
+ "$schema": "http://json-schema.org/draft-07/schema#"
170
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "$ref": "#/definitions/ControlGcRequest",
3
+ "definitions": {
4
+ "ControlGcRequest": {
5
+ "type": "object",
6
+ "properties": {
7
+ "dry_run": {
8
+ "type": "boolean",
9
+ "default": false,
10
+ "description": "Report what WOULD be deleted without touching disk."
11
+ }
12
+ },
13
+ "additionalProperties": false,
14
+ "description": "Run one retention pass over engine-owned runtime artifacts."
15
+ }
16
+ },
17
+ "$schema": "http://json-schema.org/draft-07/schema#"
18
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "$ref": "#/definitions/ControlHandshakeRequest",
3
+ "definitions": {
4
+ "ControlHandshakeRequest": {
5
+ "type": "object",
6
+ "properties": {
7
+ "protocolMajor": {
8
+ "type": "integer",
9
+ "exclusiveMinimum": 0
10
+ },
11
+ "client": {
12
+ "type": "string",
13
+ "minLength": 1,
14
+ "maxLength": 80
15
+ }
16
+ },
17
+ "required": [
18
+ "protocolMajor",
19
+ "client"
20
+ ],
21
+ "additionalProperties": false,
22
+ "description": "Control-plane protocol negotiation requested before product calls."
23
+ }
24
+ },
25
+ "$schema": "http://json-schema.org/draft-07/schema#"
26
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "$ref": "#/definitions/ControlHandshakeResponse",
3
+ "definitions": {
4
+ "ControlHandshakeResponse": {
5
+ "type": "object",
6
+ "properties": {
7
+ "protocolMajor": {
8
+ "type": "number",
9
+ "const": 2
10
+ },
11
+ "compatible": {
12
+ "type": "boolean",
13
+ "const": true
14
+ },
15
+ "operationsPath": {
16
+ "type": "string",
17
+ "const": "/v2/operations"
18
+ }
19
+ },
20
+ "required": [
21
+ "protocolMajor",
22
+ "compatible",
23
+ "operationsPath"
24
+ ],
25
+ "additionalProperties": false,
26
+ "description": "Successful v2 control-plane negotiation."
27
+ }
28
+ },
29
+ "$schema": "http://json-schema.org/draft-07/schema#"
30
+ }