@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
package/generated/ControlSetupJobListResponse.schema.json CHANGED
@@ -19,21 +19,22 @@
19
19
  "enum": [
20
20
  "codex",
21
21
  "claude",
22
- "cursor",
23
- "opencode",
24
- "raw"
22
+ "cursor"
25
23
  ],
26
- "description": "Harness ids that have a managed setup flow."
24
+ "description": "Harness ids with a managed native-login flow."
27
25
  },
28
26
  "action": {
29
27
  "type": "string",
30
- "enum": [
31
- "install",
32
- "login",
33
- "doctor",
34
- "store_key"
28
+ "const": "login",
29
+ "description": "The daemon-managed native-login action."
30
+ },
31
+ "profileId": {
32
+ "type": [
33
+ "string",
34
+ "null"
35
35
  ],
36
- "description": "Setup action to perform: install the vendor CLI, log in, run the doctor, or store an API key."
36
+ "default": null,
37
+ "description": "Registered profile this login targets; null = the default session."
37
38
  },
38
39
  "state": {
39
40
  "type": "string",
@@ -44,17 +45,79 @@
44
45
  "succeeded",
45
46
  "failed",
46
47
  "cancelled",
48
+ "timed_out",
49
+ "interrupted_unknown",
47
50
  "not_supported"
48
51
  ],
49
52
  "description": "Lifecycle state of a setup job, including waiting_for_input (needs user confirmation/input) and not_supported."
50
53
  },
54
+ "phase": {
55
+ "type": "string",
56
+ "enum": [
57
+ "preparing",
58
+ "launching",
59
+ "awaiting_user",
60
+ "verifying",
61
+ "cancelling",
62
+ "completed"
63
+ ],
64
+ "description": "Fine-grained setup phase; cancellation remains a phase until the underlying process has actually stopped."
65
+ },
66
+ "deadlineAt": {
67
+ "type": "string",
68
+ "format": "date-time",
69
+ "description": "Current native-login deadline when the job has one."
70
+ },
71
+ "outcome": {
72
+ "type": "object",
73
+ "properties": {
74
+ "reason": {
75
+ "type": "string",
76
+ "enum": [
77
+ "completed",
78
+ "not_supported",
79
+ "launch_failed",
80
+ "command_failed",
81
+ "auth_not_ready",
82
+ "capability_verification_failed",
83
+ "credential_route_mismatch",
84
+ "timed_out",
85
+ "cancelled_by_user",
86
+ "cancelled_on_restart",
87
+ "interrupted",
88
+ "interrupted_unknown",
89
+ "termination_unconfirmed"
90
+ ]
91
+ },
92
+ "exitCode": {
93
+ "anyOf": [
94
+ {
95
+ "type": "integer"
96
+ },
97
+ {
98
+ "type": "null"
99
+ }
100
+ ]
101
+ },
102
+ "signal": {
103
+ "type": [
104
+ "string",
105
+ "null"
106
+ ]
107
+ }
108
+ },
109
+ "required": [
110
+ "reason"
111
+ ],
112
+ "additionalProperties": false,
113
+ "description": "Typed terminal setup outcome with native command evidence when available."
114
+ },
51
115
  "command": {
52
116
  "type": [
53
117
  "string",
54
118
  "null"
55
119
  ],
56
- "default": null,
57
- "description": "Shell command the job runs, when applicable."
120
+ "description": "Display-only native-login command description, when available."
58
121
  },
59
122
  "guideUrl": {
60
123
  "anyOf": [
@@ -66,75 +129,713 @@
66
129
  "type": "null"
67
130
  }
68
131
  ],
69
- "default": null,
70
- "description": "Vendor guide URL for manual steps, when applicable."
71
- },
72
- "logPath": {
73
- "type": [
74
- "string",
75
- "null"
76
- ],
77
- "default": null,
78
- "description": "On-disk log path for the job's output."
132
+ "description": "Official vendor login guide URL."
79
133
  },
80
134
  "message": {
81
135
  "type": "string",
82
136
  "description": "Human-readable status message."
83
137
  },
84
- "riskFlags": {
85
- "type": "array",
86
- "items": {
87
- "type": "string"
88
- },
89
- "default": [],
90
- "description": "Risk flags for the action (e.g. network_download, shell_pipe), surfaced before confirmation."
91
- },
92
- "requiresConfirmation": {
93
- "type": "boolean",
94
- "default": false,
95
- "description": "Whether the job waits for explicit user confirmation before running."
96
- },
97
138
  "createdAt": {
98
139
  "type": "string",
140
+ "format": "date-time",
99
141
  "description": "When the job was created."
100
142
  },
101
143
  "startedAt": {
102
- "type": [
103
- "string",
104
- "null"
144
+ "anyOf": [
145
+ {
146
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/deadlineAt"
147
+ },
148
+ {
149
+ "type": "null"
150
+ }
105
151
  ],
106
- "default": null,
107
152
  "description": "When the job started running."
108
153
  },
109
- "firstOutputAt": {
110
- "type": [
111
- "string",
112
- "null"
154
+ "finishedAt": {
155
+ "anyOf": [
156
+ {
157
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/deadlineAt"
158
+ },
159
+ {
160
+ "type": "null"
161
+ }
113
162
  ],
114
- "default": null,
115
- "description": "When the job produced its first output."
163
+ "description": "When the job finished."
116
164
  },
117
- "lastOutputAt": {
118
- "type": [
119
- "string",
120
- "null"
165
+ "authCapability": {
166
+ "anyOf": [
167
+ {
168
+ "type": "object",
169
+ "properties": {
170
+ "attemptId": {
171
+ "type": "string",
172
+ "minLength": 1,
173
+ "description": "Non-empty identifier string."
174
+ },
175
+ "challengeDigest": {
176
+ "type": "string",
177
+ "pattern": "^[a-f0-9]{64}$"
178
+ },
179
+ "requestDigest": {
180
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
181
+ },
182
+ "disclosure": {
183
+ "type": "object",
184
+ "properties": {
185
+ "schemaVersion": {
186
+ "type": "number",
187
+ "const": 1
188
+ },
189
+ "protocolVersion": {
190
+ "type": "number",
191
+ "const": 1
192
+ },
193
+ "harness": {
194
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/attemptId"
195
+ },
196
+ "requested": {
197
+ "type": "string",
198
+ "enum": [
199
+ "subscription",
200
+ "api_key",
201
+ "auto"
202
+ ],
203
+ "description": "Requested credential behavior: exact subscription, exact managed API key, or policy-governed auto selection."
204
+ },
205
+ "requiredRoute": {
206
+ "type": "string",
207
+ "enum": [
208
+ "vendor_native",
209
+ "managed_api_key",
210
+ "local"
211
+ ],
212
+ "description": "Effective credential route: vendor-owned native session, Claudexor-managed API key, or credential-free local execution."
213
+ },
214
+ "requiredSource": {
215
+ "type": "string",
216
+ "enum": [
217
+ "native_session",
218
+ "oauth_token_env",
219
+ "api_key_env",
220
+ "api_key_flag",
221
+ "provider_auth_file",
222
+ "none"
223
+ ],
224
+ "description": "Concrete credential source used or probed by a harness."
225
+ },
226
+ "networkScope": {
227
+ "type": "string",
228
+ "const": "selected_harness_only"
229
+ },
230
+ "billingKnowledge": {
231
+ "type": "string",
232
+ "enum": [
233
+ "proven_zero",
234
+ "subscription_entitlement",
235
+ "metered",
236
+ "unknown"
237
+ ],
238
+ "description": "What is actually known about incremental billing; a native credential route alone never proves entitlement or zero cost."
239
+ },
240
+ "incrementalCostKnowledge": {
241
+ "type": "string",
242
+ "enum": [
243
+ "exact",
244
+ "estimated",
245
+ "unknown"
246
+ ],
247
+ "description": "Quality of incremental-cash cost evidence for an operation."
248
+ },
249
+ "mayConsumeQuota": {
250
+ "type": "boolean"
251
+ },
252
+ "generatedAt": {
253
+ "type": "string",
254
+ "format": "date-time"
255
+ }
256
+ },
257
+ "required": [
258
+ "schemaVersion",
259
+ "protocolVersion",
260
+ "harness",
261
+ "requested",
262
+ "requiredRoute",
263
+ "requiredSource",
264
+ "networkScope",
265
+ "billingKnowledge",
266
+ "incrementalCostKnowledge",
267
+ "mayConsumeQuota",
268
+ "generatedAt"
269
+ ],
270
+ "additionalProperties": false,
271
+ "description": "Pre-execution disclosure for the exact same-harness capability smoke required by auth setup."
272
+ },
273
+ "state": {
274
+ "type": "string",
275
+ "const": "disclosed"
276
+ }
277
+ },
278
+ "required": [
279
+ "attemptId",
280
+ "challengeDigest",
281
+ "requestDigest",
282
+ "disclosure",
283
+ "state"
284
+ ],
285
+ "additionalProperties": false
286
+ },
287
+ {
288
+ "type": "object",
289
+ "properties": {
290
+ "attemptId": {
291
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/attemptId"
292
+ },
293
+ "challengeDigest": {
294
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
295
+ },
296
+ "requestDigest": {
297
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
298
+ },
299
+ "disclosure": {
300
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure"
301
+ },
302
+ "state": {
303
+ "type": "string",
304
+ "const": "running"
305
+ },
306
+ "startedAt": {
307
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/generatedAt"
308
+ }
309
+ },
310
+ "required": [
311
+ "attemptId",
312
+ "challengeDigest",
313
+ "requestDigest",
314
+ "disclosure",
315
+ "state",
316
+ "startedAt"
317
+ ],
318
+ "additionalProperties": false
319
+ },
320
+ {
321
+ "type": "object",
322
+ "properties": {
323
+ "attemptId": {
324
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/attemptId"
325
+ },
326
+ "challengeDigest": {
327
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
328
+ },
329
+ "requestDigest": {
330
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
331
+ },
332
+ "disclosure": {
333
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure"
334
+ },
335
+ "state": {
336
+ "type": "string",
337
+ "const": "completed"
338
+ },
339
+ "startedAt": {
340
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/generatedAt"
341
+ },
342
+ "completedAt": {
343
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/generatedAt"
344
+ },
345
+ "receipt": {
346
+ "type": "object",
347
+ "properties": {
348
+ "receiptId": {
349
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/attemptId"
350
+ },
351
+ "attemptId": {
352
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/attemptId"
353
+ },
354
+ "harness": {
355
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/attemptId"
356
+ },
357
+ "requested": {
358
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/requested"
359
+ },
360
+ "requiredRoute": {
361
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/requiredRoute"
362
+ },
363
+ "requiredSource": {
364
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/requiredSource"
365
+ },
366
+ "effective": {
367
+ "anyOf": [
368
+ {
369
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/requiredRoute"
370
+ },
371
+ {
372
+ "type": "null"
373
+ }
374
+ ],
375
+ "description": "Effective credential route: vendor-owned native session, Claudexor-managed API key, or credential-free local execution."
376
+ },
377
+ "effectiveSource": {
378
+ "anyOf": [
379
+ {
380
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/requiredSource"
381
+ },
382
+ {
383
+ "type": "null"
384
+ }
385
+ ],
386
+ "description": "Concrete credential source used or probed by a harness."
387
+ },
388
+ "selectionReason": {
389
+ "type": "string",
390
+ "enum": [
391
+ "exact_requested_route",
392
+ "adapter_unavailable",
393
+ "request_mismatch",
394
+ "route_missing",
395
+ "route_mismatch",
396
+ "source_missing",
397
+ "source_mismatch",
398
+ "harness_error",
399
+ "adapter_error",
400
+ "missing_completion",
401
+ "response_mismatch",
402
+ "scratch_mutated",
403
+ "protocol_violation",
404
+ "adapter_identity_mismatch",
405
+ "cancelled"
406
+ ]
407
+ },
408
+ "availability": {
409
+ "type": "string",
410
+ "enum": [
411
+ "available",
412
+ "unavailable",
413
+ "unknown"
414
+ ]
415
+ },
416
+ "verification": {
417
+ "type": "string",
418
+ "enum": [
419
+ "passed",
420
+ "failed",
421
+ "not_run"
422
+ ]
423
+ },
424
+ "billingKnowledge": {
425
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/billingKnowledge"
426
+ },
427
+ "costKnowledge": {
428
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/incrementalCostKnowledge"
429
+ },
430
+ "costUsd": {
431
+ "type": "number",
432
+ "minimum": 0
433
+ },
434
+ "startedAt": {
435
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/generatedAt"
436
+ },
437
+ "completedAt": {
438
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/generatedAt"
439
+ },
440
+ "challengeDigest": {
441
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
442
+ },
443
+ "requestDigest": {
444
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
445
+ },
446
+ "responseDigest": {
447
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
448
+ },
449
+ "streamDigest": {
450
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
451
+ },
452
+ "scratchBeforeDigest": {
453
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
454
+ },
455
+ "scratchAfterDigest": {
456
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
457
+ },
458
+ "stream": {
459
+ "type": "object",
460
+ "properties": {
461
+ "startedEvents": {
462
+ "type": "integer",
463
+ "minimum": 0
464
+ },
465
+ "completedEvents": {
466
+ "type": "integer",
467
+ "minimum": 0
468
+ },
469
+ "errorEvents": {
470
+ "type": "integer",
471
+ "minimum": 0
472
+ },
473
+ "unexpectedToolEvents": {
474
+ "type": "integer",
475
+ "minimum": 0
476
+ },
477
+ "interactionEvents": {
478
+ "type": "integer",
479
+ "minimum": 0
480
+ },
481
+ "sessionMismatchEvents": {
482
+ "type": "integer",
483
+ "minimum": 0
484
+ },
485
+ "eventsAfterCompleted": {
486
+ "type": "integer",
487
+ "minimum": 0
488
+ },
489
+ "aborted": {
490
+ "type": "boolean"
491
+ }
492
+ },
493
+ "required": [
494
+ "startedEvents",
495
+ "completedEvents",
496
+ "errorEvents",
497
+ "unexpectedToolEvents",
498
+ "interactionEvents",
499
+ "sessionMismatchEvents",
500
+ "eventsAfterCompleted",
501
+ "aborted"
502
+ ],
503
+ "additionalProperties": false
504
+ },
505
+ "evidenceRefs": {
506
+ "type": "array",
507
+ "items": {
508
+ "type": "string",
509
+ "minLength": 1
510
+ }
511
+ }
512
+ },
513
+ "required": [
514
+ "receiptId",
515
+ "attemptId",
516
+ "harness",
517
+ "requested",
518
+ "requiredRoute",
519
+ "requiredSource",
520
+ "effective",
521
+ "effectiveSource",
522
+ "selectionReason",
523
+ "availability",
524
+ "verification",
525
+ "billingKnowledge",
526
+ "costKnowledge",
527
+ "startedAt",
528
+ "completedAt",
529
+ "challengeDigest",
530
+ "requestDigest",
531
+ "responseDigest",
532
+ "streamDigest",
533
+ "scratchBeforeDigest",
534
+ "scratchAfterDigest",
535
+ "stream",
536
+ "evidenceRefs"
537
+ ],
538
+ "additionalProperties": false,
539
+ "description": "Immutable result of one exact-route same-harness capability smoke."
540
+ }
541
+ },
542
+ "required": [
543
+ "attemptId",
544
+ "challengeDigest",
545
+ "requestDigest",
546
+ "disclosure",
547
+ "state",
548
+ "startedAt",
549
+ "completedAt",
550
+ "receipt"
551
+ ],
552
+ "additionalProperties": false
553
+ },
554
+ {
555
+ "type": "object",
556
+ "properties": {
557
+ "attemptId": {
558
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/attemptId"
559
+ },
560
+ "challengeDigest": {
561
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
562
+ },
563
+ "requestDigest": {
564
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/challengeDigest"
565
+ },
566
+ "disclosure": {
567
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure"
568
+ },
569
+ "state": {
570
+ "type": "string",
571
+ "const": "interrupted_unknown"
572
+ },
573
+ "startedAt": {
574
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/generatedAt"
575
+ },
576
+ "interruptedAt": {
577
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/authCapability/anyOf/0/properties/disclosure/properties/generatedAt"
578
+ }
579
+ },
580
+ "required": [
581
+ "attemptId",
582
+ "challengeDigest",
583
+ "requestDigest",
584
+ "disclosure",
585
+ "state",
586
+ "startedAt",
587
+ "interruptedAt"
588
+ ],
589
+ "additionalProperties": false
590
+ }
121
591
  ],
122
- "default": null,
123
- "description": "When the job last produced output."
592
+ "description": "Single durable lifecycle for the exact-route same-harness capability proof."
124
593
  },
125
- "finishedAt": {
126
- "type": [
127
- "string",
128
- "null"
594
+ "execution": {
595
+ "type": "object",
596
+ "properties": {
597
+ "executionId": {
598
+ "type": "string",
599
+ "pattern": "^[A-Za-z0-9-]+$"
600
+ },
601
+ "commandDigest": {
602
+ "type": "string",
603
+ "pattern": "^[a-f0-9]{64}$"
604
+ },
605
+ "manifestDigest": {
606
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/execution/properties/commandDigest"
607
+ },
608
+ "processGroup": {
609
+ "type": "object",
610
+ "properties": {
611
+ "schemaVersion": {
612
+ "type": "number",
613
+ "const": 1
614
+ },
615
+ "pgid": {
616
+ "type": "integer",
617
+ "exclusiveMinimum": 0
618
+ },
619
+ "leader": {
620
+ "type": "object",
621
+ "properties": {
622
+ "status": {
623
+ "type": "string",
624
+ "const": "known"
625
+ },
626
+ "pid": {
627
+ "type": "integer",
628
+ "exclusiveMinimum": 0
629
+ },
630
+ "platform": {
631
+ "type": "string",
632
+ "enum": [
633
+ "linux",
634
+ "darwin"
635
+ ]
636
+ },
637
+ "source": {
638
+ "type": "string",
639
+ "enum": [
640
+ "procfs_stat",
641
+ "proc_pidinfo"
642
+ ]
643
+ },
644
+ "startToken": {
645
+ "type": "string",
646
+ "minLength": 1
647
+ },
648
+ "processGroupId": {
649
+ "type": "integer",
650
+ "exclusiveMinimum": 0
651
+ }
652
+ },
653
+ "required": [
654
+ "status",
655
+ "pid",
656
+ "platform",
657
+ "source",
658
+ "startToken",
659
+ "processGroupId"
660
+ ],
661
+ "additionalProperties": false
662
+ }
663
+ },
664
+ "required": [
665
+ "schemaVersion",
666
+ "pgid",
667
+ "leader"
668
+ ],
669
+ "additionalProperties": false
670
+ },
671
+ "observedAt": {
672
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/deadlineAt"
673
+ },
674
+ "permitIssuedAt": {
675
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/deadlineAt"
676
+ }
677
+ },
678
+ "required": [
679
+ "executionId",
680
+ "commandDigest",
681
+ "manifestDigest",
682
+ "processGroup",
683
+ "observedAt"
129
684
  ],
130
- "default": null,
131
- "description": "When the job finished."
685
+ "additionalProperties": false,
686
+ "description": "Durable process-group and pre-execution permit evidence."
687
+ },
688
+ "authorization": {
689
+ "type": "object",
690
+ "properties": {
691
+ "executionId": {
692
+ "type": "string",
693
+ "pattern": "^[A-Za-z0-9-]+$"
694
+ },
695
+ "executable": {
696
+ "type": "object",
697
+ "properties": {
698
+ "realpath": {
699
+ "type": "string",
700
+ "pattern": "^\\/"
701
+ },
702
+ "sha256": {
703
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/execution/properties/commandDigest"
704
+ },
705
+ "size": {
706
+ "type": "integer",
707
+ "minimum": 0
708
+ },
709
+ "mode": {
710
+ "type": "integer",
711
+ "minimum": 0
712
+ },
713
+ "device": {
714
+ "type": "string",
715
+ "pattern": "^[0-9]+$"
716
+ },
717
+ "inode": {
718
+ "type": "string",
719
+ "pattern": "^[0-9]+$"
720
+ }
721
+ },
722
+ "required": [
723
+ "realpath",
724
+ "sha256",
725
+ "size",
726
+ "mode",
727
+ "device",
728
+ "inode"
729
+ ],
730
+ "additionalProperties": false
731
+ },
732
+ "args": {
733
+ "type": "array",
734
+ "items": {
735
+ "type": "string"
736
+ }
737
+ },
738
+ "commandDigest": {
739
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/execution/properties/commandDigest"
740
+ },
741
+ "manifestDigest": {
742
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/execution/properties/commandDigest"
743
+ }
744
+ },
745
+ "required": [
746
+ "executionId",
747
+ "executable",
748
+ "args",
749
+ "commandDigest",
750
+ "manifestDigest"
751
+ ],
752
+ "additionalProperties": false,
753
+ "description": "Immutable hash-bound command authorized before external handoff."
132
754
  },
133
- "retryCount": {
134
- "type": "integer",
135
- "minimum": 0,
136
- "default": 0,
137
- "description": "How many times the job was retried."
755
+ "nativeCommand": {
756
+ "type": "object",
757
+ "properties": {
758
+ "executionId": {
759
+ "type": "string",
760
+ "pattern": "^[A-Za-z0-9-]+$"
761
+ },
762
+ "commandDigest": {
763
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/execution/properties/commandDigest"
764
+ },
765
+ "manifestDigest": {
766
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/execution/properties/commandDigest"
767
+ },
768
+ "permitIssuedAt": {
769
+ "anyOf": [
770
+ {
771
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/deadlineAt"
772
+ },
773
+ {
774
+ "type": "null"
775
+ }
776
+ ]
777
+ },
778
+ "commandStarted": {
779
+ "type": "boolean"
780
+ },
781
+ "exitCode": {
782
+ "anyOf": [
783
+ {
784
+ "type": "integer",
785
+ "minimum": 0
786
+ },
787
+ {
788
+ "type": "null"
789
+ }
790
+ ]
791
+ },
792
+ "signal": {
793
+ "type": [
794
+ "string",
795
+ "null"
796
+ ]
797
+ },
798
+ "errorCode": {
799
+ "type": "string",
800
+ "enum": [
801
+ "permit_timeout",
802
+ "spawn_failed"
803
+ ]
804
+ },
805
+ "finishedAt": {
806
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/deadlineAt"
807
+ }
808
+ },
809
+ "required": [
810
+ "executionId",
811
+ "commandDigest",
812
+ "manifestDigest",
813
+ "permitIssuedAt",
814
+ "commandStarted",
815
+ "exitCode",
816
+ "signal",
817
+ "finishedAt"
818
+ ],
819
+ "additionalProperties": false,
820
+ "description": "Durable result of the hash-bound native login command, persisted before capability verification."
821
+ },
822
+ "terminationReconciliation": {
823
+ "type": "object",
824
+ "properties": {
825
+ "status": {
826
+ "type": "string",
827
+ "const": "empty"
828
+ },
829
+ "observedAt": {
830
+ "$ref": "#/definitions/ControlSetupJobListResponse/properties/jobs/items/properties/deadlineAt"
831
+ }
832
+ },
833
+ "required": [
834
+ "status",
835
+ "observedAt"
836
+ ],
837
+ "additionalProperties": false,
838
+ "description": "Server-owned proof that a previously unconfirmed setup process group is empty."
138
839
  }
139
840
  },
140
841
  "required": [
@@ -142,11 +843,16 @@
142
843
  "harness",
143
844
  "action",
144
845
  "state",
846
+ "phase",
847
+ "command",
848
+ "guideUrl",
145
849
  "message",
146
- "createdAt"
850
+ "createdAt",
851
+ "startedAt",
852
+ "finishedAt"
147
853
  ],
148
854
  "additionalProperties": false,
149
- "description": "One managed harness setup job (install/login/doctor/store_key) with its lifecycle timestamps."
855
+ "description": "One daemon-managed exact-subscription native-login job."
150
856
  },
151
857
  "description": "All known setup jobs."
152
858
  }