@claudexor/cli 3.8.0 → 3.8.2

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 (96) hide show
  1. package/dist/agy-quota-source.d.ts +1 -0
  2. package/dist/agy-quota-source.d.ts.map +1 -1
  3. package/dist/agy-quota-source.js +23 -1
  4. package/dist/agy-quota-source.js.map +1 -1
  5. package/dist/claudexord.d.ts.map +1 -1
  6. package/dist/claudexord.js +9 -12
  7. package/dist/claudexord.js.map +1 -1
  8. package/dist/cli-io.d.ts +1 -0
  9. package/dist/cli-io.d.ts.map +1 -1
  10. package/dist/cli-io.js +14 -0
  11. package/dist/cli-io.js.map +1 -1
  12. package/dist/cli.js +12 -18
  13. package/dist/cli.js.map +1 -1
  14. package/dist/command-flags.d.ts.map +1 -1
  15. package/dist/command-flags.js +4 -2
  16. package/dist/command-flags.js.map +1 -1
  17. package/dist/command-registry.d.ts.map +1 -1
  18. package/dist/command-registry.js +9 -1
  19. package/dist/command-registry.js.map +1 -1
  20. package/dist/control-services.d.ts +782 -778
  21. package/dist/control-services.d.ts.map +1 -1
  22. package/dist/control-services.js +5 -28
  23. package/dist/control-services.js.map +1 -1
  24. package/dist/credential-commands.d.ts +12 -0
  25. package/dist/credential-commands.d.ts.map +1 -1
  26. package/dist/credential-commands.js +62 -2
  27. package/dist/credential-commands.js.map +1 -1
  28. package/dist/credential-profile-mutations.d.ts +2 -0
  29. package/dist/credential-profile-mutations.d.ts.map +1 -1
  30. package/dist/credential-status-invalidation.d.ts +2 -0
  31. package/dist/credential-status-invalidation.d.ts.map +1 -1
  32. package/dist/credential-status-invalidation.js +10 -0
  33. package/dist/credential-status-invalidation.js.map +1 -1
  34. package/dist/daemon-admission-runtime.d.ts.map +1 -1
  35. package/dist/daemon-admission-runtime.js +36 -12
  36. package/dist/daemon-admission-runtime.js.map +1 -1
  37. package/dist/daemon-launch.d.ts +6 -0
  38. package/dist/daemon-launch.d.ts.map +1 -1
  39. package/dist/daemon-launch.js +1 -1
  40. package/dist/daemon-launch.js.map +1 -1
  41. package/dist/harness-install-recipes.d.ts +2 -2
  42. package/dist/harness-install-recipes.d.ts.map +1 -1
  43. package/dist/harness-install-recipes.js +2 -2
  44. package/dist/harness-install-recipes.js.map +1 -1
  45. package/dist/harness-installer.d.ts +1 -1
  46. package/dist/harness-installer.js +1 -1
  47. package/dist/mcp-catalog-query.d.ts +2 -0
  48. package/dist/mcp-catalog-query.d.ts.map +1 -0
  49. package/dist/mcp-catalog-query.js +28 -0
  50. package/dist/mcp-catalog-query.js.map +1 -0
  51. package/dist/mcp-run-projections.d.ts +1 -1
  52. package/dist/mcp-runner.d.ts.map +1 -1
  53. package/dist/mcp-runner.js +2 -21
  54. package/dist/mcp-runner.js.map +1 -1
  55. package/dist/ops-command-specs.d.ts +18 -2
  56. package/dist/ops-command-specs.d.ts.map +1 -1
  57. package/dist/ops-command-specs.js +12 -0
  58. package/dist/ops-command-specs.js.map +1 -1
  59. package/dist/ops-commands.d.ts.map +1 -1
  60. package/dist/ops-commands.js +3 -1
  61. package/dist/ops-commands.js.map +1 -1
  62. package/dist/plugins.d.ts.map +1 -1
  63. package/dist/plugins.js +19 -25
  64. package/dist/plugins.js.map +1 -1
  65. package/dist/profile-registration.js +1 -1
  66. package/dist/request-preflight.d.ts +1 -1
  67. package/dist/request-preflight.d.ts.map +1 -1
  68. package/dist/request-preflight.js +35 -11
  69. package/dist/request-preflight.js.map +1 -1
  70. package/dist/retry-command.d.ts.map +1 -1
  71. package/dist/retry-command.js +4 -0
  72. package/dist/retry-command.js.map +1 -1
  73. package/dist/review-command.d.ts.map +1 -1
  74. package/dist/review-command.js +6 -3
  75. package/dist/review-command.js.map +1 -1
  76. package/dist/reviewer-options.d.ts +7 -1
  77. package/dist/reviewer-options.d.ts.map +1 -1
  78. package/dist/reviewer-options.js +25 -1
  79. package/dist/reviewer-options.js.map +1 -1
  80. package/dist/run-options.d.ts +1 -1
  81. package/dist/run-options.d.ts.map +1 -1
  82. package/dist/run-options.js +12 -2
  83. package/dist/run-options.js.map +1 -1
  84. package/dist/setup-job-control-services.d.ts +2064 -0
  85. package/dist/setup-job-control-services.d.ts.map +1 -0
  86. package/dist/setup-job-control-services.js +33 -0
  87. package/dist/setup-job-control-services.js.map +1 -0
  88. package/dist/setup-login-runner.d.ts +1 -0
  89. package/dist/setup-login-runner.d.ts.map +1 -1
  90. package/dist/setup-login-runner.js +14 -0
  91. package/dist/setup-login-runner.js.map +1 -1
  92. package/dist/thread-execution-workspace.d.ts +11 -6
  93. package/dist/thread-execution-workspace.d.ts.map +1 -1
  94. package/dist/thread-execution-workspace.js +52 -6
  95. package/dist/thread-execution-workspace.js.map +1 -1
  96. package/package.json +24 -24
@@ -0,0 +1,2064 @@
1
+ import type { createSetupJobManager } from "./setup-jobs.js";
2
+ type SetupJobManager = ReturnType<typeof createSetupJobManager>;
3
+ /** Thin Control API bindings over setup-job admission and durable lifecycle operations. */
4
+ export declare function setupJobControlServices(setupJobs: () => SetupJobManager): {
5
+ createSetupJob: (input: {
6
+ request: unknown;
7
+ idempotencyKey: string;
8
+ clientId: string;
9
+ }) => Promise<{
10
+ jobId: string;
11
+ harness: "agy" | "claude" | "codex" | "cursor";
12
+ action: "login";
13
+ transport: "client_pty" | "daemon";
14
+ profileId: string | null;
15
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
16
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
17
+ deadlineAt?: string | undefined;
18
+ deadlineFixed?: boolean | undefined;
19
+ outcome?: {
20
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
21
+ exitCode?: number | null | undefined;
22
+ signal?: string | null | undefined;
23
+ } | undefined;
24
+ command: string | null;
25
+ guideUrl: string | null;
26
+ message: string;
27
+ createdAt: string;
28
+ startedAt: string | null;
29
+ finishedAt: string | null;
30
+ authCapability?: {
31
+ attemptId: string;
32
+ challengeDigest: string;
33
+ requestDigest: string;
34
+ disclosure: {
35
+ schemaVersion: 1;
36
+ protocolVersion: 1;
37
+ harness: string;
38
+ requested: "api_key" | "auto" | "subscription";
39
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
40
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
41
+ networkScope: "selected_harness_only";
42
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
43
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
44
+ mayConsumeQuota: boolean;
45
+ generatedAt: string;
46
+ };
47
+ state: "disclosed";
48
+ } | {
49
+ attemptId: string;
50
+ challengeDigest: string;
51
+ requestDigest: string;
52
+ disclosure: {
53
+ schemaVersion: 1;
54
+ protocolVersion: 1;
55
+ harness: string;
56
+ requested: "api_key" | "auto" | "subscription";
57
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
58
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
59
+ networkScope: "selected_harness_only";
60
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
61
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
62
+ mayConsumeQuota: boolean;
63
+ generatedAt: string;
64
+ };
65
+ state: "running";
66
+ startedAt: string;
67
+ } | {
68
+ attemptId: string;
69
+ challengeDigest: string;
70
+ requestDigest: string;
71
+ disclosure: {
72
+ schemaVersion: 1;
73
+ protocolVersion: 1;
74
+ harness: string;
75
+ requested: "api_key" | "auto" | "subscription";
76
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
77
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
78
+ networkScope: "selected_harness_only";
79
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
80
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
81
+ mayConsumeQuota: boolean;
82
+ generatedAt: string;
83
+ };
84
+ state: "completed";
85
+ startedAt: string;
86
+ completedAt: string;
87
+ receipt: {
88
+ receiptId: string;
89
+ attemptId: string;
90
+ harness: string;
91
+ requested: "api_key" | "auto" | "subscription";
92
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
93
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
94
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
95
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
96
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
97
+ availability: "available" | "unavailable" | "unknown";
98
+ verification: "failed" | "not_run" | "passed";
99
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
100
+ costKnowledge: "estimated" | "exact" | "unknown";
101
+ costUsd?: number | undefined;
102
+ startedAt: string;
103
+ completedAt: string;
104
+ challengeDigest: string;
105
+ requestDigest: string;
106
+ responseDigest: string;
107
+ streamDigest: string;
108
+ scratchBeforeDigest: string;
109
+ scratchAfterDigest: string;
110
+ stream: {
111
+ startedEvents: number;
112
+ completedEvents: number;
113
+ errorEvents: number;
114
+ unexpectedToolEvents: number;
115
+ interactionEvents: number;
116
+ sessionMismatchEvents: number;
117
+ eventsAfterCompleted: number;
118
+ aborted: boolean;
119
+ };
120
+ evidenceRefs: string[];
121
+ };
122
+ } | {
123
+ attemptId: string;
124
+ challengeDigest: string;
125
+ requestDigest: string;
126
+ disclosure: {
127
+ schemaVersion: 1;
128
+ protocolVersion: 1;
129
+ harness: string;
130
+ requested: "api_key" | "auto" | "subscription";
131
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
132
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
133
+ networkScope: "selected_harness_only";
134
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
135
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
136
+ mayConsumeQuota: boolean;
137
+ generatedAt: string;
138
+ };
139
+ state: "interrupted_unknown";
140
+ startedAt: string;
141
+ interruptedAt: string;
142
+ } | undefined;
143
+ execution?: {
144
+ executionId: string;
145
+ commandDigest: string;
146
+ manifestDigest: string;
147
+ processGroup: {
148
+ schemaVersion: 1;
149
+ pgid: number;
150
+ leader: {
151
+ status: "known";
152
+ pid: number;
153
+ platform: "darwin" | "linux" | "win32";
154
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
155
+ startToken: string;
156
+ processGroupId: number;
157
+ };
158
+ };
159
+ observedAt: string;
160
+ permitIssuedAt?: string | undefined;
161
+ } | undefined;
162
+ authorization?: {
163
+ executionId: string;
164
+ executable: {
165
+ realpath: string;
166
+ sha256: string;
167
+ size: number;
168
+ mode: number;
169
+ device: string;
170
+ inode: string;
171
+ };
172
+ args: string[];
173
+ commandDigest: string;
174
+ manifestDigest: string;
175
+ } | undefined;
176
+ nativeCommand?: {
177
+ executionId: string;
178
+ commandDigest: string;
179
+ manifestDigest: string;
180
+ permitIssuedAt: string | null;
181
+ commandStarted: boolean;
182
+ exitCode: number | null;
183
+ signal: string | null;
184
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
185
+ finishedAt: string;
186
+ } | undefined;
187
+ terminationReconciliation?: {
188
+ status: "empty";
189
+ observedAt: string;
190
+ } | undefined;
191
+ }>;
192
+ listSetupJobs: (input?: unknown) => Promise<{
193
+ jobs: {
194
+ jobId: string;
195
+ harness: "agy" | "claude" | "codex" | "cursor";
196
+ action: "login";
197
+ transport: "client_pty" | "daemon";
198
+ profileId: string | null;
199
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
200
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
201
+ deadlineAt?: string | undefined;
202
+ deadlineFixed?: boolean | undefined;
203
+ outcome?: {
204
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
205
+ exitCode?: number | null | undefined;
206
+ signal?: string | null | undefined;
207
+ } | undefined;
208
+ command: string | null;
209
+ guideUrl: string | null;
210
+ message: string;
211
+ createdAt: string;
212
+ startedAt: string | null;
213
+ finishedAt: string | null;
214
+ authCapability?: {
215
+ attemptId: string;
216
+ challengeDigest: string;
217
+ requestDigest: string;
218
+ disclosure: {
219
+ schemaVersion: 1;
220
+ protocolVersion: 1;
221
+ harness: string;
222
+ requested: "api_key" | "auto" | "subscription";
223
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
224
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
225
+ networkScope: "selected_harness_only";
226
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
227
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
228
+ mayConsumeQuota: boolean;
229
+ generatedAt: string;
230
+ };
231
+ state: "disclosed";
232
+ } | {
233
+ attemptId: string;
234
+ challengeDigest: string;
235
+ requestDigest: string;
236
+ disclosure: {
237
+ schemaVersion: 1;
238
+ protocolVersion: 1;
239
+ harness: string;
240
+ requested: "api_key" | "auto" | "subscription";
241
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
242
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
243
+ networkScope: "selected_harness_only";
244
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
245
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
246
+ mayConsumeQuota: boolean;
247
+ generatedAt: string;
248
+ };
249
+ state: "running";
250
+ startedAt: string;
251
+ } | {
252
+ attemptId: string;
253
+ challengeDigest: string;
254
+ requestDigest: string;
255
+ disclosure: {
256
+ schemaVersion: 1;
257
+ protocolVersion: 1;
258
+ harness: string;
259
+ requested: "api_key" | "auto" | "subscription";
260
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
261
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
262
+ networkScope: "selected_harness_only";
263
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
264
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
265
+ mayConsumeQuota: boolean;
266
+ generatedAt: string;
267
+ };
268
+ state: "completed";
269
+ startedAt: string;
270
+ completedAt: string;
271
+ receipt: {
272
+ receiptId: string;
273
+ attemptId: string;
274
+ harness: string;
275
+ requested: "api_key" | "auto" | "subscription";
276
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
277
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
278
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
279
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
280
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
281
+ availability: "available" | "unavailable" | "unknown";
282
+ verification: "failed" | "not_run" | "passed";
283
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
284
+ costKnowledge: "estimated" | "exact" | "unknown";
285
+ costUsd?: number | undefined;
286
+ startedAt: string;
287
+ completedAt: string;
288
+ challengeDigest: string;
289
+ requestDigest: string;
290
+ responseDigest: string;
291
+ streamDigest: string;
292
+ scratchBeforeDigest: string;
293
+ scratchAfterDigest: string;
294
+ stream: {
295
+ startedEvents: number;
296
+ completedEvents: number;
297
+ errorEvents: number;
298
+ unexpectedToolEvents: number;
299
+ interactionEvents: number;
300
+ sessionMismatchEvents: number;
301
+ eventsAfterCompleted: number;
302
+ aborted: boolean;
303
+ };
304
+ evidenceRefs: string[];
305
+ };
306
+ } | {
307
+ attemptId: string;
308
+ challengeDigest: string;
309
+ requestDigest: string;
310
+ disclosure: {
311
+ schemaVersion: 1;
312
+ protocolVersion: 1;
313
+ harness: string;
314
+ requested: "api_key" | "auto" | "subscription";
315
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
316
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
317
+ networkScope: "selected_harness_only";
318
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
319
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
320
+ mayConsumeQuota: boolean;
321
+ generatedAt: string;
322
+ };
323
+ state: "interrupted_unknown";
324
+ startedAt: string;
325
+ interruptedAt: string;
326
+ } | undefined;
327
+ execution?: {
328
+ executionId: string;
329
+ commandDigest: string;
330
+ manifestDigest: string;
331
+ processGroup: {
332
+ schemaVersion: 1;
333
+ pgid: number;
334
+ leader: {
335
+ status: "known";
336
+ pid: number;
337
+ platform: "darwin" | "linux" | "win32";
338
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
339
+ startToken: string;
340
+ processGroupId: number;
341
+ };
342
+ };
343
+ observedAt: string;
344
+ permitIssuedAt?: string | undefined;
345
+ } | undefined;
346
+ authorization?: {
347
+ executionId: string;
348
+ executable: {
349
+ realpath: string;
350
+ sha256: string;
351
+ size: number;
352
+ mode: number;
353
+ device: string;
354
+ inode: string;
355
+ };
356
+ args: string[];
357
+ commandDigest: string;
358
+ manifestDigest: string;
359
+ } | undefined;
360
+ nativeCommand?: {
361
+ executionId: string;
362
+ commandDigest: string;
363
+ manifestDigest: string;
364
+ permitIssuedAt: string | null;
365
+ commandStarted: boolean;
366
+ exitCode: number | null;
367
+ signal: string | null;
368
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
369
+ finishedAt: string;
370
+ } | undefined;
371
+ terminationReconciliation?: {
372
+ status: "empty";
373
+ observedAt: string;
374
+ } | undefined;
375
+ }[];
376
+ }>;
377
+ setupJobStatus: (input: unknown) => Promise<{
378
+ jobId: string;
379
+ harness: "agy" | "claude" | "codex" | "cursor";
380
+ action: "login";
381
+ transport: "client_pty" | "daemon";
382
+ profileId: string | null;
383
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
384
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
385
+ deadlineAt?: string | undefined;
386
+ deadlineFixed?: boolean | undefined;
387
+ outcome?: {
388
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
389
+ exitCode?: number | null | undefined;
390
+ signal?: string | null | undefined;
391
+ } | undefined;
392
+ command: string | null;
393
+ guideUrl: string | null;
394
+ message: string;
395
+ createdAt: string;
396
+ startedAt: string | null;
397
+ finishedAt: string | null;
398
+ authCapability?: {
399
+ attemptId: string;
400
+ challengeDigest: string;
401
+ requestDigest: string;
402
+ disclosure: {
403
+ schemaVersion: 1;
404
+ protocolVersion: 1;
405
+ harness: string;
406
+ requested: "api_key" | "auto" | "subscription";
407
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
408
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
409
+ networkScope: "selected_harness_only";
410
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
411
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
412
+ mayConsumeQuota: boolean;
413
+ generatedAt: string;
414
+ };
415
+ state: "disclosed";
416
+ } | {
417
+ attemptId: string;
418
+ challengeDigest: string;
419
+ requestDigest: string;
420
+ disclosure: {
421
+ schemaVersion: 1;
422
+ protocolVersion: 1;
423
+ harness: string;
424
+ requested: "api_key" | "auto" | "subscription";
425
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
426
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
427
+ networkScope: "selected_harness_only";
428
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
429
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
430
+ mayConsumeQuota: boolean;
431
+ generatedAt: string;
432
+ };
433
+ state: "running";
434
+ startedAt: string;
435
+ } | {
436
+ attemptId: string;
437
+ challengeDigest: string;
438
+ requestDigest: string;
439
+ disclosure: {
440
+ schemaVersion: 1;
441
+ protocolVersion: 1;
442
+ harness: string;
443
+ requested: "api_key" | "auto" | "subscription";
444
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
445
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
446
+ networkScope: "selected_harness_only";
447
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
448
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
449
+ mayConsumeQuota: boolean;
450
+ generatedAt: string;
451
+ };
452
+ state: "completed";
453
+ startedAt: string;
454
+ completedAt: string;
455
+ receipt: {
456
+ receiptId: string;
457
+ attemptId: string;
458
+ harness: string;
459
+ requested: "api_key" | "auto" | "subscription";
460
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
461
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
462
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
463
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
464
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
465
+ availability: "available" | "unavailable" | "unknown";
466
+ verification: "failed" | "not_run" | "passed";
467
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
468
+ costKnowledge: "estimated" | "exact" | "unknown";
469
+ costUsd?: number | undefined;
470
+ startedAt: string;
471
+ completedAt: string;
472
+ challengeDigest: string;
473
+ requestDigest: string;
474
+ responseDigest: string;
475
+ streamDigest: string;
476
+ scratchBeforeDigest: string;
477
+ scratchAfterDigest: string;
478
+ stream: {
479
+ startedEvents: number;
480
+ completedEvents: number;
481
+ errorEvents: number;
482
+ unexpectedToolEvents: number;
483
+ interactionEvents: number;
484
+ sessionMismatchEvents: number;
485
+ eventsAfterCompleted: number;
486
+ aborted: boolean;
487
+ };
488
+ evidenceRefs: string[];
489
+ };
490
+ } | {
491
+ attemptId: string;
492
+ challengeDigest: string;
493
+ requestDigest: string;
494
+ disclosure: {
495
+ schemaVersion: 1;
496
+ protocolVersion: 1;
497
+ harness: string;
498
+ requested: "api_key" | "auto" | "subscription";
499
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
500
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
501
+ networkScope: "selected_harness_only";
502
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
503
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
504
+ mayConsumeQuota: boolean;
505
+ generatedAt: string;
506
+ };
507
+ state: "interrupted_unknown";
508
+ startedAt: string;
509
+ interruptedAt: string;
510
+ } | undefined;
511
+ execution?: {
512
+ executionId: string;
513
+ commandDigest: string;
514
+ manifestDigest: string;
515
+ processGroup: {
516
+ schemaVersion: 1;
517
+ pgid: number;
518
+ leader: {
519
+ status: "known";
520
+ pid: number;
521
+ platform: "darwin" | "linux" | "win32";
522
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
523
+ startToken: string;
524
+ processGroupId: number;
525
+ };
526
+ };
527
+ observedAt: string;
528
+ permitIssuedAt?: string | undefined;
529
+ } | undefined;
530
+ authorization?: {
531
+ executionId: string;
532
+ executable: {
533
+ realpath: string;
534
+ sha256: string;
535
+ size: number;
536
+ mode: number;
537
+ device: string;
538
+ inode: string;
539
+ };
540
+ args: string[];
541
+ commandDigest: string;
542
+ manifestDigest: string;
543
+ } | undefined;
544
+ nativeCommand?: {
545
+ executionId: string;
546
+ commandDigest: string;
547
+ manifestDigest: string;
548
+ permitIssuedAt: string | null;
549
+ commandStarted: boolean;
550
+ exitCode: number | null;
551
+ signal: string | null;
552
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
553
+ finishedAt: string;
554
+ } | undefined;
555
+ terminationReconciliation?: {
556
+ status: "empty";
557
+ observedAt: string;
558
+ } | undefined;
559
+ }>;
560
+ setupJobSnapshot: (input: unknown) => Promise<{
561
+ deviceCode?: undefined;
562
+ job: {
563
+ jobId: string;
564
+ harness: "agy" | "claude" | "codex" | "cursor";
565
+ action: "login";
566
+ transport: "client_pty" | "daemon";
567
+ profileId: string | null;
568
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
569
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
570
+ deadlineAt?: string | undefined;
571
+ deadlineFixed?: boolean | undefined;
572
+ outcome?: {
573
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
574
+ exitCode?: number | null | undefined;
575
+ signal?: string | null | undefined;
576
+ } | undefined;
577
+ command: string | null;
578
+ guideUrl: string | null;
579
+ message: string;
580
+ createdAt: string;
581
+ startedAt: string | null;
582
+ finishedAt: string | null;
583
+ authCapability?: {
584
+ attemptId: string;
585
+ challengeDigest: string;
586
+ requestDigest: string;
587
+ disclosure: {
588
+ schemaVersion: 1;
589
+ protocolVersion: 1;
590
+ harness: string;
591
+ requested: "api_key" | "auto" | "subscription";
592
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
593
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
594
+ networkScope: "selected_harness_only";
595
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
596
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
597
+ mayConsumeQuota: boolean;
598
+ generatedAt: string;
599
+ };
600
+ state: "disclosed";
601
+ } | {
602
+ attemptId: string;
603
+ challengeDigest: string;
604
+ requestDigest: string;
605
+ disclosure: {
606
+ schemaVersion: 1;
607
+ protocolVersion: 1;
608
+ harness: string;
609
+ requested: "api_key" | "auto" | "subscription";
610
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
611
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
612
+ networkScope: "selected_harness_only";
613
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
614
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
615
+ mayConsumeQuota: boolean;
616
+ generatedAt: string;
617
+ };
618
+ state: "running";
619
+ startedAt: string;
620
+ } | {
621
+ attemptId: string;
622
+ challengeDigest: string;
623
+ requestDigest: string;
624
+ disclosure: {
625
+ schemaVersion: 1;
626
+ protocolVersion: 1;
627
+ harness: string;
628
+ requested: "api_key" | "auto" | "subscription";
629
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
630
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
631
+ networkScope: "selected_harness_only";
632
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
633
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
634
+ mayConsumeQuota: boolean;
635
+ generatedAt: string;
636
+ };
637
+ state: "completed";
638
+ startedAt: string;
639
+ completedAt: string;
640
+ receipt: {
641
+ receiptId: string;
642
+ attemptId: string;
643
+ harness: string;
644
+ requested: "api_key" | "auto" | "subscription";
645
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
646
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
647
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
648
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
649
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
650
+ availability: "available" | "unavailable" | "unknown";
651
+ verification: "failed" | "not_run" | "passed";
652
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
653
+ costKnowledge: "estimated" | "exact" | "unknown";
654
+ costUsd?: number | undefined;
655
+ startedAt: string;
656
+ completedAt: string;
657
+ challengeDigest: string;
658
+ requestDigest: string;
659
+ responseDigest: string;
660
+ streamDigest: string;
661
+ scratchBeforeDigest: string;
662
+ scratchAfterDigest: string;
663
+ stream: {
664
+ startedEvents: number;
665
+ completedEvents: number;
666
+ errorEvents: number;
667
+ unexpectedToolEvents: number;
668
+ interactionEvents: number;
669
+ sessionMismatchEvents: number;
670
+ eventsAfterCompleted: number;
671
+ aborted: boolean;
672
+ };
673
+ evidenceRefs: string[];
674
+ };
675
+ } | {
676
+ attemptId: string;
677
+ challengeDigest: string;
678
+ requestDigest: string;
679
+ disclosure: {
680
+ schemaVersion: 1;
681
+ protocolVersion: 1;
682
+ harness: string;
683
+ requested: "api_key" | "auto" | "subscription";
684
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
685
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
686
+ networkScope: "selected_harness_only";
687
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
688
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
689
+ mayConsumeQuota: boolean;
690
+ generatedAt: string;
691
+ };
692
+ state: "interrupted_unknown";
693
+ startedAt: string;
694
+ interruptedAt: string;
695
+ } | undefined;
696
+ execution?: {
697
+ executionId: string;
698
+ commandDigest: string;
699
+ manifestDigest: string;
700
+ processGroup: {
701
+ schemaVersion: 1;
702
+ pgid: number;
703
+ leader: {
704
+ status: "known";
705
+ pid: number;
706
+ platform: "darwin" | "linux" | "win32";
707
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
708
+ startToken: string;
709
+ processGroupId: number;
710
+ };
711
+ };
712
+ observedAt: string;
713
+ permitIssuedAt?: string | undefined;
714
+ } | undefined;
715
+ authorization?: {
716
+ executionId: string;
717
+ executable: {
718
+ realpath: string;
719
+ sha256: string;
720
+ size: number;
721
+ mode: number;
722
+ device: string;
723
+ inode: string;
724
+ };
725
+ args: string[];
726
+ commandDigest: string;
727
+ manifestDigest: string;
728
+ } | undefined;
729
+ nativeCommand?: {
730
+ executionId: string;
731
+ commandDigest: string;
732
+ manifestDigest: string;
733
+ permitIssuedAt: string | null;
734
+ commandStarted: boolean;
735
+ exitCode: number | null;
736
+ signal: string | null;
737
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
738
+ finishedAt: string;
739
+ } | undefined;
740
+ terminationReconciliation?: {
741
+ status: "empty";
742
+ observedAt: string;
743
+ } | undefined;
744
+ };
745
+ cursor: string;
746
+ sequence: number;
747
+ } | {
748
+ job: {
749
+ jobId: string;
750
+ harness: "agy" | "claude" | "codex" | "cursor";
751
+ action: "login";
752
+ transport: "client_pty" | "daemon";
753
+ profileId: string | null;
754
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
755
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
756
+ deadlineAt?: string | undefined;
757
+ deadlineFixed?: boolean | undefined;
758
+ outcome?: {
759
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
760
+ exitCode?: number | null | undefined;
761
+ signal?: string | null | undefined;
762
+ } | undefined;
763
+ command: string | null;
764
+ guideUrl: string | null;
765
+ message: string;
766
+ createdAt: string;
767
+ startedAt: string | null;
768
+ finishedAt: string | null;
769
+ authCapability?: {
770
+ attemptId: string;
771
+ challengeDigest: string;
772
+ requestDigest: string;
773
+ disclosure: {
774
+ schemaVersion: 1;
775
+ protocolVersion: 1;
776
+ harness: string;
777
+ requested: "api_key" | "auto" | "subscription";
778
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
779
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
780
+ networkScope: "selected_harness_only";
781
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
782
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
783
+ mayConsumeQuota: boolean;
784
+ generatedAt: string;
785
+ };
786
+ state: "disclosed";
787
+ } | {
788
+ attemptId: string;
789
+ challengeDigest: string;
790
+ requestDigest: string;
791
+ disclosure: {
792
+ schemaVersion: 1;
793
+ protocolVersion: 1;
794
+ harness: string;
795
+ requested: "api_key" | "auto" | "subscription";
796
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
797
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
798
+ networkScope: "selected_harness_only";
799
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
800
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
801
+ mayConsumeQuota: boolean;
802
+ generatedAt: string;
803
+ };
804
+ state: "running";
805
+ startedAt: string;
806
+ } | {
807
+ attemptId: string;
808
+ challengeDigest: string;
809
+ requestDigest: string;
810
+ disclosure: {
811
+ schemaVersion: 1;
812
+ protocolVersion: 1;
813
+ harness: string;
814
+ requested: "api_key" | "auto" | "subscription";
815
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
816
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
817
+ networkScope: "selected_harness_only";
818
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
819
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
820
+ mayConsumeQuota: boolean;
821
+ generatedAt: string;
822
+ };
823
+ state: "completed";
824
+ startedAt: string;
825
+ completedAt: string;
826
+ receipt: {
827
+ receiptId: string;
828
+ attemptId: string;
829
+ harness: string;
830
+ requested: "api_key" | "auto" | "subscription";
831
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
832
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
833
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
834
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
835
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
836
+ availability: "available" | "unavailable" | "unknown";
837
+ verification: "failed" | "not_run" | "passed";
838
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
839
+ costKnowledge: "estimated" | "exact" | "unknown";
840
+ costUsd?: number | undefined;
841
+ startedAt: string;
842
+ completedAt: string;
843
+ challengeDigest: string;
844
+ requestDigest: string;
845
+ responseDigest: string;
846
+ streamDigest: string;
847
+ scratchBeforeDigest: string;
848
+ scratchAfterDigest: string;
849
+ stream: {
850
+ startedEvents: number;
851
+ completedEvents: number;
852
+ errorEvents: number;
853
+ unexpectedToolEvents: number;
854
+ interactionEvents: number;
855
+ sessionMismatchEvents: number;
856
+ eventsAfterCompleted: number;
857
+ aborted: boolean;
858
+ };
859
+ evidenceRefs: string[];
860
+ };
861
+ } | {
862
+ attemptId: string;
863
+ challengeDigest: string;
864
+ requestDigest: string;
865
+ disclosure: {
866
+ schemaVersion: 1;
867
+ protocolVersion: 1;
868
+ harness: string;
869
+ requested: "api_key" | "auto" | "subscription";
870
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
871
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
872
+ networkScope: "selected_harness_only";
873
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
874
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
875
+ mayConsumeQuota: boolean;
876
+ generatedAt: string;
877
+ };
878
+ state: "interrupted_unknown";
879
+ startedAt: string;
880
+ interruptedAt: string;
881
+ } | undefined;
882
+ execution?: {
883
+ executionId: string;
884
+ commandDigest: string;
885
+ manifestDigest: string;
886
+ processGroup: {
887
+ schemaVersion: 1;
888
+ pgid: number;
889
+ leader: {
890
+ status: "known";
891
+ pid: number;
892
+ platform: "darwin" | "linux" | "win32";
893
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
894
+ startToken: string;
895
+ processGroupId: number;
896
+ };
897
+ };
898
+ observedAt: string;
899
+ permitIssuedAt?: string | undefined;
900
+ } | undefined;
901
+ authorization?: {
902
+ executionId: string;
903
+ executable: {
904
+ realpath: string;
905
+ sha256: string;
906
+ size: number;
907
+ mode: number;
908
+ device: string;
909
+ inode: string;
910
+ };
911
+ args: string[];
912
+ commandDigest: string;
913
+ manifestDigest: string;
914
+ } | undefined;
915
+ nativeCommand?: {
916
+ executionId: string;
917
+ commandDigest: string;
918
+ manifestDigest: string;
919
+ permitIssuedAt: string | null;
920
+ commandStarted: boolean;
921
+ exitCode: number | null;
922
+ signal: string | null;
923
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
924
+ finishedAt: string;
925
+ } | undefined;
926
+ terminationReconciliation?: {
927
+ status: "empty";
928
+ observedAt: string;
929
+ } | undefined;
930
+ };
931
+ cursor: string;
932
+ sequence: number;
933
+ deviceCode: {
934
+ flow: "chatgpt" | "chatgptDeviceCode" | "oauth_url" | "oauth_url_input";
935
+ verificationUrl: string;
936
+ userCode: string;
937
+ };
938
+ }>;
939
+ setupJobEvents: (input: unknown) => Promise<({
940
+ deviceCode?: undefined;
941
+ jobId: string;
942
+ cursor: string;
943
+ previousCursor: string | null;
944
+ sequence: number;
945
+ time: string;
946
+ kind: "status";
947
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
948
+ message: string;
949
+ job: {
950
+ jobId: string;
951
+ harness: "agy" | "claude" | "codex" | "cursor";
952
+ action: "login";
953
+ transport: "client_pty" | "daemon";
954
+ profileId: string | null;
955
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
956
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
957
+ deadlineAt?: string | undefined;
958
+ deadlineFixed?: boolean | undefined;
959
+ outcome?: {
960
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
961
+ exitCode?: number | null | undefined;
962
+ signal?: string | null | undefined;
963
+ } | undefined;
964
+ command: string | null;
965
+ guideUrl: string | null;
966
+ message: string;
967
+ createdAt: string;
968
+ startedAt: string | null;
969
+ finishedAt: string | null;
970
+ authCapability?: {
971
+ attemptId: string;
972
+ challengeDigest: string;
973
+ requestDigest: string;
974
+ disclosure: {
975
+ schemaVersion: 1;
976
+ protocolVersion: 1;
977
+ harness: string;
978
+ requested: "api_key" | "auto" | "subscription";
979
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
980
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
981
+ networkScope: "selected_harness_only";
982
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
983
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
984
+ mayConsumeQuota: boolean;
985
+ generatedAt: string;
986
+ };
987
+ state: "disclosed";
988
+ } | {
989
+ attemptId: string;
990
+ challengeDigest: string;
991
+ requestDigest: string;
992
+ disclosure: {
993
+ schemaVersion: 1;
994
+ protocolVersion: 1;
995
+ harness: string;
996
+ requested: "api_key" | "auto" | "subscription";
997
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
998
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
999
+ networkScope: "selected_harness_only";
1000
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1001
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1002
+ mayConsumeQuota: boolean;
1003
+ generatedAt: string;
1004
+ };
1005
+ state: "running";
1006
+ startedAt: string;
1007
+ } | {
1008
+ attemptId: string;
1009
+ challengeDigest: string;
1010
+ requestDigest: string;
1011
+ disclosure: {
1012
+ schemaVersion: 1;
1013
+ protocolVersion: 1;
1014
+ harness: string;
1015
+ requested: "api_key" | "auto" | "subscription";
1016
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1017
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1018
+ networkScope: "selected_harness_only";
1019
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1020
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1021
+ mayConsumeQuota: boolean;
1022
+ generatedAt: string;
1023
+ };
1024
+ state: "completed";
1025
+ startedAt: string;
1026
+ completedAt: string;
1027
+ receipt: {
1028
+ receiptId: string;
1029
+ attemptId: string;
1030
+ harness: string;
1031
+ requested: "api_key" | "auto" | "subscription";
1032
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1033
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1034
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
1035
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
1036
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
1037
+ availability: "available" | "unavailable" | "unknown";
1038
+ verification: "failed" | "not_run" | "passed";
1039
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1040
+ costKnowledge: "estimated" | "exact" | "unknown";
1041
+ costUsd?: number | undefined;
1042
+ startedAt: string;
1043
+ completedAt: string;
1044
+ challengeDigest: string;
1045
+ requestDigest: string;
1046
+ responseDigest: string;
1047
+ streamDigest: string;
1048
+ scratchBeforeDigest: string;
1049
+ scratchAfterDigest: string;
1050
+ stream: {
1051
+ startedEvents: number;
1052
+ completedEvents: number;
1053
+ errorEvents: number;
1054
+ unexpectedToolEvents: number;
1055
+ interactionEvents: number;
1056
+ sessionMismatchEvents: number;
1057
+ eventsAfterCompleted: number;
1058
+ aborted: boolean;
1059
+ };
1060
+ evidenceRefs: string[];
1061
+ };
1062
+ } | {
1063
+ attemptId: string;
1064
+ challengeDigest: string;
1065
+ requestDigest: string;
1066
+ disclosure: {
1067
+ schemaVersion: 1;
1068
+ protocolVersion: 1;
1069
+ harness: string;
1070
+ requested: "api_key" | "auto" | "subscription";
1071
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1072
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1073
+ networkScope: "selected_harness_only";
1074
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1075
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1076
+ mayConsumeQuota: boolean;
1077
+ generatedAt: string;
1078
+ };
1079
+ state: "interrupted_unknown";
1080
+ startedAt: string;
1081
+ interruptedAt: string;
1082
+ } | undefined;
1083
+ execution?: {
1084
+ executionId: string;
1085
+ commandDigest: string;
1086
+ manifestDigest: string;
1087
+ processGroup: {
1088
+ schemaVersion: 1;
1089
+ pgid: number;
1090
+ leader: {
1091
+ status: "known";
1092
+ pid: number;
1093
+ platform: "darwin" | "linux" | "win32";
1094
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
1095
+ startToken: string;
1096
+ processGroupId: number;
1097
+ };
1098
+ };
1099
+ observedAt: string;
1100
+ permitIssuedAt?: string | undefined;
1101
+ } | undefined;
1102
+ authorization?: {
1103
+ executionId: string;
1104
+ executable: {
1105
+ realpath: string;
1106
+ sha256: string;
1107
+ size: number;
1108
+ mode: number;
1109
+ device: string;
1110
+ inode: string;
1111
+ };
1112
+ args: string[];
1113
+ commandDigest: string;
1114
+ manifestDigest: string;
1115
+ } | undefined;
1116
+ nativeCommand?: {
1117
+ executionId: string;
1118
+ commandDigest: string;
1119
+ manifestDigest: string;
1120
+ permitIssuedAt: string | null;
1121
+ commandStarted: boolean;
1122
+ exitCode: number | null;
1123
+ signal: string | null;
1124
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
1125
+ finishedAt: string;
1126
+ } | undefined;
1127
+ terminationReconciliation?: {
1128
+ status: "empty";
1129
+ observedAt: string;
1130
+ } | undefined;
1131
+ };
1132
+ } | {
1133
+ jobId: string;
1134
+ cursor: string;
1135
+ previousCursor: string | null;
1136
+ sequence: number;
1137
+ time: string;
1138
+ kind: "status";
1139
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
1140
+ message: string;
1141
+ job: {
1142
+ jobId: string;
1143
+ harness: "agy" | "claude" | "codex" | "cursor";
1144
+ action: "login";
1145
+ transport: "client_pty" | "daemon";
1146
+ profileId: string | null;
1147
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
1148
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
1149
+ deadlineAt?: string | undefined;
1150
+ deadlineFixed?: boolean | undefined;
1151
+ outcome?: {
1152
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
1153
+ exitCode?: number | null | undefined;
1154
+ signal?: string | null | undefined;
1155
+ } | undefined;
1156
+ command: string | null;
1157
+ guideUrl: string | null;
1158
+ message: string;
1159
+ createdAt: string;
1160
+ startedAt: string | null;
1161
+ finishedAt: string | null;
1162
+ authCapability?: {
1163
+ attemptId: string;
1164
+ challengeDigest: string;
1165
+ requestDigest: string;
1166
+ disclosure: {
1167
+ schemaVersion: 1;
1168
+ protocolVersion: 1;
1169
+ harness: string;
1170
+ requested: "api_key" | "auto" | "subscription";
1171
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1172
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1173
+ networkScope: "selected_harness_only";
1174
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1175
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1176
+ mayConsumeQuota: boolean;
1177
+ generatedAt: string;
1178
+ };
1179
+ state: "disclosed";
1180
+ } | {
1181
+ attemptId: string;
1182
+ challengeDigest: string;
1183
+ requestDigest: string;
1184
+ disclosure: {
1185
+ schemaVersion: 1;
1186
+ protocolVersion: 1;
1187
+ harness: string;
1188
+ requested: "api_key" | "auto" | "subscription";
1189
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1190
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1191
+ networkScope: "selected_harness_only";
1192
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1193
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1194
+ mayConsumeQuota: boolean;
1195
+ generatedAt: string;
1196
+ };
1197
+ state: "running";
1198
+ startedAt: string;
1199
+ } | {
1200
+ attemptId: string;
1201
+ challengeDigest: string;
1202
+ requestDigest: string;
1203
+ disclosure: {
1204
+ schemaVersion: 1;
1205
+ protocolVersion: 1;
1206
+ harness: string;
1207
+ requested: "api_key" | "auto" | "subscription";
1208
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1209
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1210
+ networkScope: "selected_harness_only";
1211
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1212
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1213
+ mayConsumeQuota: boolean;
1214
+ generatedAt: string;
1215
+ };
1216
+ state: "completed";
1217
+ startedAt: string;
1218
+ completedAt: string;
1219
+ receipt: {
1220
+ receiptId: string;
1221
+ attemptId: string;
1222
+ harness: string;
1223
+ requested: "api_key" | "auto" | "subscription";
1224
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1225
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1226
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
1227
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
1228
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
1229
+ availability: "available" | "unavailable" | "unknown";
1230
+ verification: "failed" | "not_run" | "passed";
1231
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1232
+ costKnowledge: "estimated" | "exact" | "unknown";
1233
+ costUsd?: number | undefined;
1234
+ startedAt: string;
1235
+ completedAt: string;
1236
+ challengeDigest: string;
1237
+ requestDigest: string;
1238
+ responseDigest: string;
1239
+ streamDigest: string;
1240
+ scratchBeforeDigest: string;
1241
+ scratchAfterDigest: string;
1242
+ stream: {
1243
+ startedEvents: number;
1244
+ completedEvents: number;
1245
+ errorEvents: number;
1246
+ unexpectedToolEvents: number;
1247
+ interactionEvents: number;
1248
+ sessionMismatchEvents: number;
1249
+ eventsAfterCompleted: number;
1250
+ aborted: boolean;
1251
+ };
1252
+ evidenceRefs: string[];
1253
+ };
1254
+ } | {
1255
+ attemptId: string;
1256
+ challengeDigest: string;
1257
+ requestDigest: string;
1258
+ disclosure: {
1259
+ schemaVersion: 1;
1260
+ protocolVersion: 1;
1261
+ harness: string;
1262
+ requested: "api_key" | "auto" | "subscription";
1263
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1264
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1265
+ networkScope: "selected_harness_only";
1266
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1267
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1268
+ mayConsumeQuota: boolean;
1269
+ generatedAt: string;
1270
+ };
1271
+ state: "interrupted_unknown";
1272
+ startedAt: string;
1273
+ interruptedAt: string;
1274
+ } | undefined;
1275
+ execution?: {
1276
+ executionId: string;
1277
+ commandDigest: string;
1278
+ manifestDigest: string;
1279
+ processGroup: {
1280
+ schemaVersion: 1;
1281
+ pgid: number;
1282
+ leader: {
1283
+ status: "known";
1284
+ pid: number;
1285
+ platform: "darwin" | "linux" | "win32";
1286
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
1287
+ startToken: string;
1288
+ processGroupId: number;
1289
+ };
1290
+ };
1291
+ observedAt: string;
1292
+ permitIssuedAt?: string | undefined;
1293
+ } | undefined;
1294
+ authorization?: {
1295
+ executionId: string;
1296
+ executable: {
1297
+ realpath: string;
1298
+ sha256: string;
1299
+ size: number;
1300
+ mode: number;
1301
+ device: string;
1302
+ inode: string;
1303
+ };
1304
+ args: string[];
1305
+ commandDigest: string;
1306
+ manifestDigest: string;
1307
+ } | undefined;
1308
+ nativeCommand?: {
1309
+ executionId: string;
1310
+ commandDigest: string;
1311
+ manifestDigest: string;
1312
+ permitIssuedAt: string | null;
1313
+ commandStarted: boolean;
1314
+ exitCode: number | null;
1315
+ signal: string | null;
1316
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
1317
+ finishedAt: string;
1318
+ } | undefined;
1319
+ terminationReconciliation?: {
1320
+ status: "empty";
1321
+ observedAt: string;
1322
+ } | undefined;
1323
+ };
1324
+ deviceCode: {
1325
+ flow: "chatgpt" | "chatgptDeviceCode" | "oauth_url" | "oauth_url_input";
1326
+ verificationUrl: string;
1327
+ userCode: string;
1328
+ };
1329
+ })[]>;
1330
+ cancelSetupJob: (input: unknown) => Promise<{
1331
+ jobId: string;
1332
+ harness: "agy" | "claude" | "codex" | "cursor";
1333
+ action: "login";
1334
+ transport: "client_pty" | "daemon";
1335
+ profileId: string | null;
1336
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
1337
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
1338
+ deadlineAt?: string | undefined;
1339
+ deadlineFixed?: boolean | undefined;
1340
+ outcome?: {
1341
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
1342
+ exitCode?: number | null | undefined;
1343
+ signal?: string | null | undefined;
1344
+ } | undefined;
1345
+ command: string | null;
1346
+ guideUrl: string | null;
1347
+ message: string;
1348
+ createdAt: string;
1349
+ startedAt: string | null;
1350
+ finishedAt: string | null;
1351
+ authCapability?: {
1352
+ attemptId: string;
1353
+ challengeDigest: string;
1354
+ requestDigest: string;
1355
+ disclosure: {
1356
+ schemaVersion: 1;
1357
+ protocolVersion: 1;
1358
+ harness: string;
1359
+ requested: "api_key" | "auto" | "subscription";
1360
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1361
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1362
+ networkScope: "selected_harness_only";
1363
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1364
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1365
+ mayConsumeQuota: boolean;
1366
+ generatedAt: string;
1367
+ };
1368
+ state: "disclosed";
1369
+ } | {
1370
+ attemptId: string;
1371
+ challengeDigest: string;
1372
+ requestDigest: string;
1373
+ disclosure: {
1374
+ schemaVersion: 1;
1375
+ protocolVersion: 1;
1376
+ harness: string;
1377
+ requested: "api_key" | "auto" | "subscription";
1378
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1379
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1380
+ networkScope: "selected_harness_only";
1381
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1382
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1383
+ mayConsumeQuota: boolean;
1384
+ generatedAt: string;
1385
+ };
1386
+ state: "running";
1387
+ startedAt: string;
1388
+ } | {
1389
+ attemptId: string;
1390
+ challengeDigest: string;
1391
+ requestDigest: string;
1392
+ disclosure: {
1393
+ schemaVersion: 1;
1394
+ protocolVersion: 1;
1395
+ harness: string;
1396
+ requested: "api_key" | "auto" | "subscription";
1397
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1398
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1399
+ networkScope: "selected_harness_only";
1400
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1401
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1402
+ mayConsumeQuota: boolean;
1403
+ generatedAt: string;
1404
+ };
1405
+ state: "completed";
1406
+ startedAt: string;
1407
+ completedAt: string;
1408
+ receipt: {
1409
+ receiptId: string;
1410
+ attemptId: string;
1411
+ harness: string;
1412
+ requested: "api_key" | "auto" | "subscription";
1413
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1414
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1415
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
1416
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
1417
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
1418
+ availability: "available" | "unavailable" | "unknown";
1419
+ verification: "failed" | "not_run" | "passed";
1420
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1421
+ costKnowledge: "estimated" | "exact" | "unknown";
1422
+ costUsd?: number | undefined;
1423
+ startedAt: string;
1424
+ completedAt: string;
1425
+ challengeDigest: string;
1426
+ requestDigest: string;
1427
+ responseDigest: string;
1428
+ streamDigest: string;
1429
+ scratchBeforeDigest: string;
1430
+ scratchAfterDigest: string;
1431
+ stream: {
1432
+ startedEvents: number;
1433
+ completedEvents: number;
1434
+ errorEvents: number;
1435
+ unexpectedToolEvents: number;
1436
+ interactionEvents: number;
1437
+ sessionMismatchEvents: number;
1438
+ eventsAfterCompleted: number;
1439
+ aborted: boolean;
1440
+ };
1441
+ evidenceRefs: string[];
1442
+ };
1443
+ } | {
1444
+ attemptId: string;
1445
+ challengeDigest: string;
1446
+ requestDigest: string;
1447
+ disclosure: {
1448
+ schemaVersion: 1;
1449
+ protocolVersion: 1;
1450
+ harness: string;
1451
+ requested: "api_key" | "auto" | "subscription";
1452
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1453
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1454
+ networkScope: "selected_harness_only";
1455
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1456
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1457
+ mayConsumeQuota: boolean;
1458
+ generatedAt: string;
1459
+ };
1460
+ state: "interrupted_unknown";
1461
+ startedAt: string;
1462
+ interruptedAt: string;
1463
+ } | undefined;
1464
+ execution?: {
1465
+ executionId: string;
1466
+ commandDigest: string;
1467
+ manifestDigest: string;
1468
+ processGroup: {
1469
+ schemaVersion: 1;
1470
+ pgid: number;
1471
+ leader: {
1472
+ status: "known";
1473
+ pid: number;
1474
+ platform: "darwin" | "linux" | "win32";
1475
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
1476
+ startToken: string;
1477
+ processGroupId: number;
1478
+ };
1479
+ };
1480
+ observedAt: string;
1481
+ permitIssuedAt?: string | undefined;
1482
+ } | undefined;
1483
+ authorization?: {
1484
+ executionId: string;
1485
+ executable: {
1486
+ realpath: string;
1487
+ sha256: string;
1488
+ size: number;
1489
+ mode: number;
1490
+ device: string;
1491
+ inode: string;
1492
+ };
1493
+ args: string[];
1494
+ commandDigest: string;
1495
+ manifestDigest: string;
1496
+ } | undefined;
1497
+ nativeCommand?: {
1498
+ executionId: string;
1499
+ commandDigest: string;
1500
+ manifestDigest: string;
1501
+ permitIssuedAt: string | null;
1502
+ commandStarted: boolean;
1503
+ exitCode: number | null;
1504
+ signal: string | null;
1505
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
1506
+ finishedAt: string;
1507
+ } | undefined;
1508
+ terminationReconciliation?: {
1509
+ status: "empty";
1510
+ observedAt: string;
1511
+ } | undefined;
1512
+ }>;
1513
+ setupJobInput: (input: unknown) => Promise<{
1514
+ jobId: string;
1515
+ harness: "agy" | "claude" | "codex" | "cursor";
1516
+ action: "login";
1517
+ transport: "client_pty" | "daemon";
1518
+ profileId: string | null;
1519
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
1520
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
1521
+ deadlineAt?: string | undefined;
1522
+ deadlineFixed?: boolean | undefined;
1523
+ outcome?: {
1524
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
1525
+ exitCode?: number | null | undefined;
1526
+ signal?: string | null | undefined;
1527
+ } | undefined;
1528
+ command: string | null;
1529
+ guideUrl: string | null;
1530
+ message: string;
1531
+ createdAt: string;
1532
+ startedAt: string | null;
1533
+ finishedAt: string | null;
1534
+ authCapability?: {
1535
+ attemptId: string;
1536
+ challengeDigest: string;
1537
+ requestDigest: string;
1538
+ disclosure: {
1539
+ schemaVersion: 1;
1540
+ protocolVersion: 1;
1541
+ harness: string;
1542
+ requested: "api_key" | "auto" | "subscription";
1543
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1544
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1545
+ networkScope: "selected_harness_only";
1546
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1547
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1548
+ mayConsumeQuota: boolean;
1549
+ generatedAt: string;
1550
+ };
1551
+ state: "disclosed";
1552
+ } | {
1553
+ attemptId: string;
1554
+ challengeDigest: string;
1555
+ requestDigest: string;
1556
+ disclosure: {
1557
+ schemaVersion: 1;
1558
+ protocolVersion: 1;
1559
+ harness: string;
1560
+ requested: "api_key" | "auto" | "subscription";
1561
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1562
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1563
+ networkScope: "selected_harness_only";
1564
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1565
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1566
+ mayConsumeQuota: boolean;
1567
+ generatedAt: string;
1568
+ };
1569
+ state: "running";
1570
+ startedAt: string;
1571
+ } | {
1572
+ attemptId: string;
1573
+ challengeDigest: string;
1574
+ requestDigest: string;
1575
+ disclosure: {
1576
+ schemaVersion: 1;
1577
+ protocolVersion: 1;
1578
+ harness: string;
1579
+ requested: "api_key" | "auto" | "subscription";
1580
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1581
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1582
+ networkScope: "selected_harness_only";
1583
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1584
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1585
+ mayConsumeQuota: boolean;
1586
+ generatedAt: string;
1587
+ };
1588
+ state: "completed";
1589
+ startedAt: string;
1590
+ completedAt: string;
1591
+ receipt: {
1592
+ receiptId: string;
1593
+ attemptId: string;
1594
+ harness: string;
1595
+ requested: "api_key" | "auto" | "subscription";
1596
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1597
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1598
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
1599
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
1600
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
1601
+ availability: "available" | "unavailable" | "unknown";
1602
+ verification: "failed" | "not_run" | "passed";
1603
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1604
+ costKnowledge: "estimated" | "exact" | "unknown";
1605
+ costUsd?: number | undefined;
1606
+ startedAt: string;
1607
+ completedAt: string;
1608
+ challengeDigest: string;
1609
+ requestDigest: string;
1610
+ responseDigest: string;
1611
+ streamDigest: string;
1612
+ scratchBeforeDigest: string;
1613
+ scratchAfterDigest: string;
1614
+ stream: {
1615
+ startedEvents: number;
1616
+ completedEvents: number;
1617
+ errorEvents: number;
1618
+ unexpectedToolEvents: number;
1619
+ interactionEvents: number;
1620
+ sessionMismatchEvents: number;
1621
+ eventsAfterCompleted: number;
1622
+ aborted: boolean;
1623
+ };
1624
+ evidenceRefs: string[];
1625
+ };
1626
+ } | {
1627
+ attemptId: string;
1628
+ challengeDigest: string;
1629
+ requestDigest: string;
1630
+ disclosure: {
1631
+ schemaVersion: 1;
1632
+ protocolVersion: 1;
1633
+ harness: string;
1634
+ requested: "api_key" | "auto" | "subscription";
1635
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1636
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1637
+ networkScope: "selected_harness_only";
1638
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1639
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1640
+ mayConsumeQuota: boolean;
1641
+ generatedAt: string;
1642
+ };
1643
+ state: "interrupted_unknown";
1644
+ startedAt: string;
1645
+ interruptedAt: string;
1646
+ } | undefined;
1647
+ execution?: {
1648
+ executionId: string;
1649
+ commandDigest: string;
1650
+ manifestDigest: string;
1651
+ processGroup: {
1652
+ schemaVersion: 1;
1653
+ pgid: number;
1654
+ leader: {
1655
+ status: "known";
1656
+ pid: number;
1657
+ platform: "darwin" | "linux" | "win32";
1658
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
1659
+ startToken: string;
1660
+ processGroupId: number;
1661
+ };
1662
+ };
1663
+ observedAt: string;
1664
+ permitIssuedAt?: string | undefined;
1665
+ } | undefined;
1666
+ authorization?: {
1667
+ executionId: string;
1668
+ executable: {
1669
+ realpath: string;
1670
+ sha256: string;
1671
+ size: number;
1672
+ mode: number;
1673
+ device: string;
1674
+ inode: string;
1675
+ };
1676
+ args: string[];
1677
+ commandDigest: string;
1678
+ manifestDigest: string;
1679
+ } | undefined;
1680
+ nativeCommand?: {
1681
+ executionId: string;
1682
+ commandDigest: string;
1683
+ manifestDigest: string;
1684
+ permitIssuedAt: string | null;
1685
+ commandStarted: boolean;
1686
+ exitCode: number | null;
1687
+ signal: string | null;
1688
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
1689
+ finishedAt: string;
1690
+ } | undefined;
1691
+ terminationReconciliation?: {
1692
+ status: "empty";
1693
+ observedAt: string;
1694
+ } | undefined;
1695
+ }>;
1696
+ reconcileSetupJob: (input: unknown) => Promise<{
1697
+ jobId: string;
1698
+ harness: "agy" | "claude" | "codex" | "cursor";
1699
+ action: "login";
1700
+ transport: "client_pty" | "daemon";
1701
+ profileId: string | null;
1702
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
1703
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
1704
+ deadlineAt?: string | undefined;
1705
+ deadlineFixed?: boolean | undefined;
1706
+ outcome?: {
1707
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
1708
+ exitCode?: number | null | undefined;
1709
+ signal?: string | null | undefined;
1710
+ } | undefined;
1711
+ command: string | null;
1712
+ guideUrl: string | null;
1713
+ message: string;
1714
+ createdAt: string;
1715
+ startedAt: string | null;
1716
+ finishedAt: string | null;
1717
+ authCapability?: {
1718
+ attemptId: string;
1719
+ challengeDigest: string;
1720
+ requestDigest: string;
1721
+ disclosure: {
1722
+ schemaVersion: 1;
1723
+ protocolVersion: 1;
1724
+ harness: string;
1725
+ requested: "api_key" | "auto" | "subscription";
1726
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1727
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1728
+ networkScope: "selected_harness_only";
1729
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1730
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1731
+ mayConsumeQuota: boolean;
1732
+ generatedAt: string;
1733
+ };
1734
+ state: "disclosed";
1735
+ } | {
1736
+ attemptId: string;
1737
+ challengeDigest: string;
1738
+ requestDigest: string;
1739
+ disclosure: {
1740
+ schemaVersion: 1;
1741
+ protocolVersion: 1;
1742
+ harness: string;
1743
+ requested: "api_key" | "auto" | "subscription";
1744
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1745
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1746
+ networkScope: "selected_harness_only";
1747
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1748
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1749
+ mayConsumeQuota: boolean;
1750
+ generatedAt: string;
1751
+ };
1752
+ state: "running";
1753
+ startedAt: string;
1754
+ } | {
1755
+ attemptId: string;
1756
+ challengeDigest: string;
1757
+ requestDigest: string;
1758
+ disclosure: {
1759
+ schemaVersion: 1;
1760
+ protocolVersion: 1;
1761
+ harness: string;
1762
+ requested: "api_key" | "auto" | "subscription";
1763
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1764
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1765
+ networkScope: "selected_harness_only";
1766
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1767
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1768
+ mayConsumeQuota: boolean;
1769
+ generatedAt: string;
1770
+ };
1771
+ state: "completed";
1772
+ startedAt: string;
1773
+ completedAt: string;
1774
+ receipt: {
1775
+ receiptId: string;
1776
+ attemptId: string;
1777
+ harness: string;
1778
+ requested: "api_key" | "auto" | "subscription";
1779
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1780
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1781
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
1782
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
1783
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
1784
+ availability: "available" | "unavailable" | "unknown";
1785
+ verification: "failed" | "not_run" | "passed";
1786
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1787
+ costKnowledge: "estimated" | "exact" | "unknown";
1788
+ costUsd?: number | undefined;
1789
+ startedAt: string;
1790
+ completedAt: string;
1791
+ challengeDigest: string;
1792
+ requestDigest: string;
1793
+ responseDigest: string;
1794
+ streamDigest: string;
1795
+ scratchBeforeDigest: string;
1796
+ scratchAfterDigest: string;
1797
+ stream: {
1798
+ startedEvents: number;
1799
+ completedEvents: number;
1800
+ errorEvents: number;
1801
+ unexpectedToolEvents: number;
1802
+ interactionEvents: number;
1803
+ sessionMismatchEvents: number;
1804
+ eventsAfterCompleted: number;
1805
+ aborted: boolean;
1806
+ };
1807
+ evidenceRefs: string[];
1808
+ };
1809
+ } | {
1810
+ attemptId: string;
1811
+ challengeDigest: string;
1812
+ requestDigest: string;
1813
+ disclosure: {
1814
+ schemaVersion: 1;
1815
+ protocolVersion: 1;
1816
+ harness: string;
1817
+ requested: "api_key" | "auto" | "subscription";
1818
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1819
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1820
+ networkScope: "selected_harness_only";
1821
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1822
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1823
+ mayConsumeQuota: boolean;
1824
+ generatedAt: string;
1825
+ };
1826
+ state: "interrupted_unknown";
1827
+ startedAt: string;
1828
+ interruptedAt: string;
1829
+ } | undefined;
1830
+ execution?: {
1831
+ executionId: string;
1832
+ commandDigest: string;
1833
+ manifestDigest: string;
1834
+ processGroup: {
1835
+ schemaVersion: 1;
1836
+ pgid: number;
1837
+ leader: {
1838
+ status: "known";
1839
+ pid: number;
1840
+ platform: "darwin" | "linux" | "win32";
1841
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
1842
+ startToken: string;
1843
+ processGroupId: number;
1844
+ };
1845
+ };
1846
+ observedAt: string;
1847
+ permitIssuedAt?: string | undefined;
1848
+ } | undefined;
1849
+ authorization?: {
1850
+ executionId: string;
1851
+ executable: {
1852
+ realpath: string;
1853
+ sha256: string;
1854
+ size: number;
1855
+ mode: number;
1856
+ device: string;
1857
+ inode: string;
1858
+ };
1859
+ args: string[];
1860
+ commandDigest: string;
1861
+ manifestDigest: string;
1862
+ } | undefined;
1863
+ nativeCommand?: {
1864
+ executionId: string;
1865
+ commandDigest: string;
1866
+ manifestDigest: string;
1867
+ permitIssuedAt: string | null;
1868
+ commandStarted: boolean;
1869
+ exitCode: number | null;
1870
+ signal: string | null;
1871
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
1872
+ finishedAt: string;
1873
+ } | undefined;
1874
+ terminationReconciliation?: {
1875
+ status: "empty";
1876
+ observedAt: string;
1877
+ } | undefined;
1878
+ }>;
1879
+ extendSetupJob: (input: unknown) => Promise<{
1880
+ jobId: string;
1881
+ harness: "agy" | "claude" | "codex" | "cursor";
1882
+ action: "login";
1883
+ transport: "client_pty" | "daemon";
1884
+ profileId: string | null;
1885
+ state: "cancelled" | "failed" | "interrupted_unknown" | "not_supported" | "queued" | "running" | "succeeded" | "timed_out" | "waiting_for_input";
1886
+ phase: "awaiting_user" | "cancelling" | "completed" | "launching" | "preparing" | "verifying";
1887
+ deadlineAt?: string | undefined;
1888
+ deadlineFixed?: boolean | undefined;
1889
+ outcome?: {
1890
+ reason: "auth_not_ready" | "cancelled_by_user" | "cancelled_on_restart" | "capability_verification_failed" | "command_failed" | "completed" | "credential_route_mismatch" | "interrupted" | "interrupted_unknown" | "launch_failed" | "not_supported" | "termination_unconfirmed" | "timed_out";
1891
+ exitCode?: number | null | undefined;
1892
+ signal?: string | null | undefined;
1893
+ } | undefined;
1894
+ command: string | null;
1895
+ guideUrl: string | null;
1896
+ message: string;
1897
+ createdAt: string;
1898
+ startedAt: string | null;
1899
+ finishedAt: string | null;
1900
+ authCapability?: {
1901
+ attemptId: string;
1902
+ challengeDigest: string;
1903
+ requestDigest: string;
1904
+ disclosure: {
1905
+ schemaVersion: 1;
1906
+ protocolVersion: 1;
1907
+ harness: string;
1908
+ requested: "api_key" | "auto" | "subscription";
1909
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1910
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1911
+ networkScope: "selected_harness_only";
1912
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1913
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1914
+ mayConsumeQuota: boolean;
1915
+ generatedAt: string;
1916
+ };
1917
+ state: "disclosed";
1918
+ } | {
1919
+ attemptId: string;
1920
+ challengeDigest: string;
1921
+ requestDigest: string;
1922
+ disclosure: {
1923
+ schemaVersion: 1;
1924
+ protocolVersion: 1;
1925
+ harness: string;
1926
+ requested: "api_key" | "auto" | "subscription";
1927
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1928
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1929
+ networkScope: "selected_harness_only";
1930
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1931
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1932
+ mayConsumeQuota: boolean;
1933
+ generatedAt: string;
1934
+ };
1935
+ state: "running";
1936
+ startedAt: string;
1937
+ } | {
1938
+ attemptId: string;
1939
+ challengeDigest: string;
1940
+ requestDigest: string;
1941
+ disclosure: {
1942
+ schemaVersion: 1;
1943
+ protocolVersion: 1;
1944
+ harness: string;
1945
+ requested: "api_key" | "auto" | "subscription";
1946
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1947
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1948
+ networkScope: "selected_harness_only";
1949
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1950
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
1951
+ mayConsumeQuota: boolean;
1952
+ generatedAt: string;
1953
+ };
1954
+ state: "completed";
1955
+ startedAt: string;
1956
+ completedAt: string;
1957
+ receipt: {
1958
+ receiptId: string;
1959
+ attemptId: string;
1960
+ harness: string;
1961
+ requested: "api_key" | "auto" | "subscription";
1962
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
1963
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
1964
+ effective: "local" | "managed_api_key" | "vendor_native" | null;
1965
+ effectiveSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file" | null;
1966
+ selectionReason: "adapter_error" | "adapter_identity_mismatch" | "adapter_unavailable" | "cancelled" | "exact_requested_route" | "harness_error" | "missing_completion" | "protocol_violation" | "request_mismatch" | "response_mismatch" | "route_mismatch" | "route_missing" | "scratch_mutated" | "source_mismatch" | "source_missing";
1967
+ availability: "available" | "unavailable" | "unknown";
1968
+ verification: "failed" | "not_run" | "passed";
1969
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
1970
+ costKnowledge: "estimated" | "exact" | "unknown";
1971
+ costUsd?: number | undefined;
1972
+ startedAt: string;
1973
+ completedAt: string;
1974
+ challengeDigest: string;
1975
+ requestDigest: string;
1976
+ responseDigest: string;
1977
+ streamDigest: string;
1978
+ scratchBeforeDigest: string;
1979
+ scratchAfterDigest: string;
1980
+ stream: {
1981
+ startedEvents: number;
1982
+ completedEvents: number;
1983
+ errorEvents: number;
1984
+ unexpectedToolEvents: number;
1985
+ interactionEvents: number;
1986
+ sessionMismatchEvents: number;
1987
+ eventsAfterCompleted: number;
1988
+ aborted: boolean;
1989
+ };
1990
+ evidenceRefs: string[];
1991
+ };
1992
+ } | {
1993
+ attemptId: string;
1994
+ challengeDigest: string;
1995
+ requestDigest: string;
1996
+ disclosure: {
1997
+ schemaVersion: 1;
1998
+ protocolVersion: 1;
1999
+ harness: string;
2000
+ requested: "api_key" | "auto" | "subscription";
2001
+ requiredRoute: "local" | "managed_api_key" | "vendor_native";
2002
+ requiredSource: "api_key_env" | "api_key_flag" | "native_session" | "none" | "oauth_token_env" | "provider_auth_file";
2003
+ networkScope: "selected_harness_only";
2004
+ billingKnowledge: "metered" | "proven_zero" | "subscription_entitlement" | "unknown";
2005
+ incrementalCostKnowledge: "estimated" | "exact" | "unknown";
2006
+ mayConsumeQuota: boolean;
2007
+ generatedAt: string;
2008
+ };
2009
+ state: "interrupted_unknown";
2010
+ startedAt: string;
2011
+ interruptedAt: string;
2012
+ } | undefined;
2013
+ execution?: {
2014
+ executionId: string;
2015
+ commandDigest: string;
2016
+ manifestDigest: string;
2017
+ processGroup: {
2018
+ schemaVersion: 1;
2019
+ pgid: number;
2020
+ leader: {
2021
+ status: "known";
2022
+ pid: number;
2023
+ platform: "darwin" | "linux" | "win32";
2024
+ source: "proc_pidinfo" | "procfs_stat" | "win32_process_times";
2025
+ startToken: string;
2026
+ processGroupId: number;
2027
+ };
2028
+ };
2029
+ observedAt: string;
2030
+ permitIssuedAt?: string | undefined;
2031
+ } | undefined;
2032
+ authorization?: {
2033
+ executionId: string;
2034
+ executable: {
2035
+ realpath: string;
2036
+ sha256: string;
2037
+ size: number;
2038
+ mode: number;
2039
+ device: string;
2040
+ inode: string;
2041
+ };
2042
+ args: string[];
2043
+ commandDigest: string;
2044
+ manifestDigest: string;
2045
+ } | undefined;
2046
+ nativeCommand?: {
2047
+ executionId: string;
2048
+ commandDigest: string;
2049
+ manifestDigest: string;
2050
+ permitIssuedAt: string | null;
2051
+ commandStarted: boolean;
2052
+ exitCode: number | null;
2053
+ signal: string | null;
2054
+ errorCode?: "device_auth_unsupported" | "permit_timeout" | "spawn_failed" | "terminal_transport_failed" | "terminal_transport_probe_failed" | "terminal_transport_unavailable" | "terminal_transport_unsupported" | undefined;
2055
+ finishedAt: string;
2056
+ } | undefined;
2057
+ terminationReconciliation?: {
2058
+ status: "empty";
2059
+ observedAt: string;
2060
+ } | undefined;
2061
+ }>;
2062
+ };
2063
+ export {};
2064
+ //# sourceMappingURL=setup-job-control-services.d.ts.map