@claudexor/schema 2.0.0 → 2.1.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 (128) hide show
  1. package/dist/agent-capabilities.d.ts +24 -24
  2. package/dist/attachment.d.ts +13 -13
  3. package/dist/auth.d.ts +21 -0
  4. package/dist/auth.d.ts.map +1 -1
  5. package/dist/auth.js +54 -0
  6. package/dist/auth.js.map +1 -1
  7. package/dist/budget.d.ts +17 -5
  8. package/dist/budget.d.ts.map +1 -1
  9. package/dist/budget.js +15 -0
  10. package/dist/budget.js.map +1 -1
  11. package/dist/config.d.ts +380 -20
  12. package/dist/config.d.ts.map +1 -1
  13. package/dist/config.js +81 -0
  14. package/dist/config.js.map +1 -1
  15. package/dist/control-gc.d.ts +185 -0
  16. package/dist/control-gc.d.ts.map +1 -0
  17. package/dist/control-gc.js +81 -0
  18. package/dist/control-gc.js.map +1 -0
  19. package/dist/control-operation-responses.d.ts +155 -29
  20. package/dist/control-operation-responses.d.ts.map +1 -1
  21. package/dist/control-run-detail.d.ts +140 -32
  22. package/dist/control-run-detail.d.ts.map +1 -1
  23. package/dist/control-spec.d.ts +6 -6
  24. package/dist/control-thread-apply.d.ts +2 -2
  25. package/dist/control.d.ts +427 -586
  26. package/dist/control.d.ts.map +1 -1
  27. package/dist/control.js +155 -54
  28. package/dist/control.js.map +1 -1
  29. package/dist/credential-profile.d.ts +454 -0
  30. package/dist/credential-profile.d.ts.map +1 -0
  31. package/dist/credential-profile.js +140 -0
  32. package/dist/credential-profile.js.map +1 -0
  33. package/dist/events.d.ts +20 -6
  34. package/dist/events.d.ts.map +1 -1
  35. package/dist/events.js +22 -0
  36. package/dist/events.js.map +1 -1
  37. package/dist/gate.d.ts +3 -3
  38. package/dist/harness.d.ts +243 -88
  39. package/dist/harness.d.ts.map +1 -1
  40. package/dist/harness.js +124 -46
  41. package/dist/harness.js.map +1 -1
  42. package/dist/index.d.ts +4 -0
  43. package/dist/index.d.ts.map +1 -1
  44. package/dist/index.js +4 -0
  45. package/dist/index.js.map +1 -1
  46. package/dist/orchestrate.d.ts +23 -0
  47. package/dist/orchestrate.d.ts.map +1 -1
  48. package/dist/orchestrate.js +56 -0
  49. package/dist/orchestrate.js.map +1 -1
  50. package/dist/project.d.ts +2 -2
  51. package/dist/quota.d.ts +27 -9
  52. package/dist/quota.d.ts.map +1 -1
  53. package/dist/quota.js +14 -2
  54. package/dist/quota.js.map +1 -1
  55. package/dist/readiness.d.ts +596 -0
  56. package/dist/readiness.d.ts.map +1 -0
  57. package/dist/readiness.js +87 -0
  58. package/dist/readiness.js.map +1 -0
  59. package/dist/request-requirements.d.ts +8 -8
  60. package/dist/request-requirements.d.ts.map +1 -1
  61. package/dist/request-requirements.js +4 -1
  62. package/dist/request-requirements.js.map +1 -1
  63. package/dist/route.d.ts +4 -4
  64. package/dist/setup.d.ts +69 -24
  65. package/dist/setup.d.ts.map +1 -1
  66. package/dist/setup.js +25 -0
  67. package/dist/setup.js.map +1 -1
  68. package/dist/spec.d.ts +4 -4
  69. package/dist/task.d.ts +99 -4
  70. package/dist/task.d.ts.map +1 -1
  71. package/dist/task.js +48 -1
  72. package/dist/task.js.map +1 -1
  73. package/dist/telemetry.d.ts +309 -67
  74. package/dist/telemetry.d.ts.map +1 -1
  75. package/dist/telemetry.js +97 -1
  76. package/dist/telemetry.js.map +1 -1
  77. package/dist/thread.d.ts +26 -15
  78. package/dist/thread.d.ts.map +1 -1
  79. package/dist/thread.js +11 -0
  80. package/dist/thread.js.map +1 -1
  81. package/dist/tool-ref.d.ts +45 -0
  82. package/dist/tool-ref.d.ts.map +1 -0
  83. package/dist/tool-ref.js +45 -0
  84. package/dist/tool-ref.js.map +1 -0
  85. package/dist/workspace.d.ts +2 -2
  86. package/generated/BudgetObservation.schema.json +16 -0
  87. package/generated/ControlCredentialProfileCreateRequest.schema.json +32 -0
  88. package/generated/ControlCredentialProfileCreateResponse.schema.json +142 -0
  89. package/generated/ControlCredentialProfileDeleteResponse.schema.json +107 -0
  90. package/generated/ControlCredentialProfilesResponse.schema.json +155 -0
  91. package/generated/ControlGcReceipt.schema.json +170 -0
  92. package/generated/ControlGcRequest.schema.json +18 -0
  93. package/generated/ControlHarnessListResponse.schema.json +95 -2
  94. package/generated/ControlHarnessModelsResponse.schema.json +19 -0
  95. package/generated/ControlHarnessSettingsPatch.schema.json +9 -0
  96. package/generated/ControlQuotaResponse.schema.json +3 -2
  97. package/generated/ControlRunAgainDraft.schema.json +40 -0
  98. package/generated/ControlRunDetail.schema.json +178 -6
  99. package/generated/ControlRunListResponse.schema.json +174 -3
  100. package/generated/ControlRunStartRequest.schema.json +40 -0
  101. package/generated/ControlRunSummary.schema.json +174 -3
  102. package/generated/ControlSettingsSnapshot.schema.json +10 -0
  103. package/generated/ControlSettingsUpdateRequest.schema.json +9 -0
  104. package/generated/ControlSetupJob.schema.json +8 -0
  105. package/generated/ControlSetupJobCreateRequest.schema.json +5 -0
  106. package/generated/ControlSetupJobEvent.schema.json +8 -0
  107. package/generated/ControlSetupJobListResponse.schema.json +8 -0
  108. package/generated/ControlSetupJobSnapshot.schema.json +8 -0
  109. package/generated/ControlThread.schema.json +16 -4
  110. package/generated/ControlThreadCreateRequest.schema.json +6 -2
  111. package/generated/ControlThreadDetail.schema.json +32 -8
  112. package/generated/ControlThreadListResponse.schema.json +16 -4
  113. package/generated/ControlThreadTurnRequest.schema.json +40 -0
  114. package/generated/ControlThreadUpdateRequest.schema.json +11 -0
  115. package/generated/CredentialProfile.schema.json +78 -0
  116. package/generated/CredentialProfileStatus.schema.json +61 -0
  117. package/generated/GlobalConfig.schema.json +136 -0
  118. package/generated/HarnessEvent.schema.json +62 -5
  119. package/generated/HarnessManifest.schema.json +33 -2
  120. package/generated/HarnessModel.schema.json +19 -0
  121. package/generated/HarnessStatusDto.schema.json +95 -2
  122. package/generated/RunEvent.schema.json +3 -0
  123. package/generated/RunTelemetry.schema.json +202 -2
  124. package/generated/Session.schema.json +14 -0
  125. package/generated/TaskContract.schema.json +65 -4
  126. package/generated/Thread.schema.json +17 -5
  127. package/generated/ThreadHeadPing.schema.json +40 -0
  128. package/package.json +3 -2
@@ -52,16 +52,16 @@ export declare const ToolErrorRecord: z.ZodObject<{
52
52
  recovered: z.ZodDefault<z.ZodBoolean>;
53
53
  tool_use_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
54
54
  }, "strip", z.ZodTypeAny, {
55
- kind: "file" | "web" | "command" | "mcp" | "search" | "other";
56
- summary: string;
55
+ kind: "web" | "file" | "command" | "mcp" | "search" | "other";
57
56
  target: string | null;
57
+ summary: string;
58
58
  tool: string;
59
59
  recovered: boolean;
60
60
  tool_use_id: string | null;
61
61
  }, {
62
62
  summary: string;
63
63
  tool: string;
64
- kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
64
+ kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
65
65
  target?: string | null | undefined;
66
66
  recovered?: boolean | undefined;
67
67
  tool_use_id?: string | null | undefined;
@@ -107,6 +107,47 @@ export declare const AttemptOutcome: z.ZodObject<{
107
107
  tool_warnings_count?: number | undefined;
108
108
  }>;
109
109
  export type AttemptOutcome = z.infer<typeof AttemptOutcome>;
110
+ /**
111
+ * Typed conformance receipt for a run started with an output schema, persisted
112
+ * as final/structured_output.yaml by the ONE engine validator. Surfaces project
113
+ * it (summary.outputConformance) and never re-validate the answer themselves.
114
+ */
115
+ export declare const StructuredOutputConformance: z.ZodObject<{
116
+ schema_version: z.ZodLiteral<2>;
117
+ status: z.ZodEnum<["passed", "failed"]>;
118
+ reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
119
+ /** Present when the answer parsed as JSON at all (even non-conformant JSON
120
+ * is materialized to help the embedder debug and retry). */
121
+ output_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
122
+ generated_at: z.ZodString;
123
+ }, "strip", z.ZodTypeAny, {
124
+ status: "passed" | "failed";
125
+ reason: string | null;
126
+ schema_version: 2;
127
+ output_path: string | null;
128
+ generated_at: string;
129
+ }, {
130
+ status: "passed" | "failed";
131
+ schema_version: 2;
132
+ generated_at: string;
133
+ reason?: string | null | undefined;
134
+ output_path?: string | null | undefined;
135
+ }>;
136
+ export type StructuredOutputConformance = z.infer<typeof StructuredOutputConformance>;
137
+ export declare const TokenUsage: z.ZodObject<{
138
+ input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
139
+ output_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
140
+ cached_input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
141
+ }, "strip", z.ZodTypeAny, {
142
+ input_tokens: number | null;
143
+ output_tokens: number | null;
144
+ cached_input_tokens: number | null;
145
+ }, {
146
+ input_tokens?: number | null | undefined;
147
+ output_tokens?: number | null | undefined;
148
+ cached_input_tokens?: number | null | undefined;
149
+ }>;
150
+ export type TokenUsage = z.infer<typeof TokenUsage>;
110
151
  export declare const AttemptTelemetryRecord: z.ZodObject<{
111
152
  attempt_id: z.ZodString;
112
153
  harness_id: z.ZodString;
@@ -126,29 +167,39 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
126
167
  * unknown, never guess from manifests.
127
168
  */
128
169
  auth_mode: z.ZodDefault<z.ZodNullable<z.ZodEnum<["local_session", "api_key", "unknown"]>>>;
170
+ /** Concrete credential source the attempt disclosed alongside its route
171
+ * (route evidence; null = undisclosed, never guessed). */
172
+ auth_source: z.ZodDefault<z.ZodNullable<z.ZodEnum<["native_session", "oauth_token_env", "api_key_env", "api_key_flag", "provider_auth_file", "none"]>>>;
173
+ /** Credential profile the attempt ACTUALLY ran under (INV-135), from the
174
+ * adapter's per-event stamp; rotation makes this differ from the run's
175
+ * requested id. Null = engine-default credentials or never disclosed. */
176
+ profile_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
177
+ /** Model hint the engine actually SENT this attempt (requested side of the
178
+ * model x route truth; observed_model is the disclosed side). */
179
+ requested_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
129
180
  request_requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
130
- capability: z.ZodLiteral<"browser">;
181
+ capability: z.ZodEnum<["browser", "path_deny"]>;
131
182
  harness_id: z.ZodString;
132
183
  eligible: z.ZodBoolean;
133
184
  requested: z.ZodBoolean;
134
185
  effective: z.ZodBoolean;
135
- reason: z.ZodEnum<["not_requested", "effective", "manifest_unsupported", "web_policy_off", "access_profile_incompatible"]>;
186
+ reason: z.ZodEnum<["not_requested", "effective", "manifest_unsupported", "web_policy_off", "access_profile_incompatible", "postdiff_only"]>;
136
187
  evidence_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
137
188
  }, "strip", z.ZodTypeAny, {
138
189
  requested: boolean;
139
190
  effective: boolean;
140
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
141
- evidence_refs: string[];
142
191
  harness_id: string;
192
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
193
+ evidence_refs: string[];
143
194
  eligible: boolean;
144
- capability: "browser";
195
+ capability: "browser" | "path_deny";
145
196
  }, {
146
197
  requested: boolean;
147
198
  effective: boolean;
148
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
149
199
  harness_id: string;
200
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
150
201
  eligible: boolean;
151
- capability: "browser";
202
+ capability: "browser" | "path_deny";
152
203
  evidence_refs?: string[] | undefined;
153
204
  }>, "many">>;
154
205
  web: z.ZodObject<{
@@ -194,16 +245,16 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
194
245
  recovered: z.ZodDefault<z.ZodBoolean>;
195
246
  tool_use_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
196
247
  }, "strip", z.ZodTypeAny, {
197
- kind: "file" | "web" | "command" | "mcp" | "search" | "other";
198
- summary: string;
248
+ kind: "web" | "file" | "command" | "mcp" | "search" | "other";
199
249
  target: string | null;
250
+ summary: string;
200
251
  tool: string;
201
252
  recovered: boolean;
202
253
  tool_use_id: string | null;
203
254
  }, {
204
255
  summary: string;
205
256
  tool: string;
206
- kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
257
+ kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
207
258
  target?: string | null | undefined;
208
259
  recovered?: boolean | undefined;
209
260
  tool_use_id?: string | null | undefined;
@@ -248,7 +299,22 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
248
299
  web_required_unsatisfied?: boolean | undefined;
249
300
  tool_warnings_count?: number | undefined;
250
301
  }>>;
302
+ /** Token usage summed across this attempt's usage events. */
303
+ usage: z.ZodDefault<z.ZodObject<{
304
+ input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
305
+ output_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
306
+ cached_input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
307
+ }, "strip", z.ZodTypeAny, {
308
+ input_tokens: number | null;
309
+ output_tokens: number | null;
310
+ cached_input_tokens: number | null;
311
+ }, {
312
+ input_tokens?: number | null | undefined;
313
+ output_tokens?: number | null | undefined;
314
+ cached_input_tokens?: number | null | undefined;
315
+ }>>;
251
316
  }, "strip", z.ZodTypeAny, {
317
+ profile_id: string | null;
252
318
  harness_id: string;
253
319
  web: {
254
320
  status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
@@ -261,6 +327,11 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
261
327
  attempted: boolean;
262
328
  satisfied: boolean;
263
329
  };
330
+ usage: {
331
+ input_tokens: number | null;
332
+ output_tokens: number | null;
333
+ cached_input_tokens: number | null;
334
+ };
264
335
  observed_model: string | null;
265
336
  attempt_id: string;
266
337
  outcome: {
@@ -271,20 +342,22 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
271
342
  web_required_unsatisfied: boolean;
272
343
  tool_warnings_count: number;
273
344
  };
345
+ requested_model: string | null;
274
346
  auth_mode: "unknown" | "api_key" | "local_session" | null;
347
+ auth_source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
275
348
  request_requirements: {
276
349
  requested: boolean;
277
350
  effective: boolean;
278
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
279
- evidence_refs: string[];
280
351
  harness_id: string;
352
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
353
+ evidence_refs: string[];
281
354
  eligible: boolean;
282
- capability: "browser";
355
+ capability: "browser" | "path_deny";
283
356
  }[];
284
357
  tool_errors: {
285
- kind: "file" | "web" | "command" | "mcp" | "search" | "other";
286
- summary: string;
358
+ kind: "web" | "file" | "command" | "mcp" | "search" | "other";
287
359
  target: string | null;
360
+ summary: string;
288
361
  tool: string;
289
362
  recovered: boolean;
290
363
  tool_use_id: string | null;
@@ -311,6 +384,12 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
311
384
  satisfied?: boolean | undefined;
312
385
  };
313
386
  attempt_id: string;
387
+ profile_id?: string | null | undefined;
388
+ usage?: {
389
+ input_tokens?: number | null | undefined;
390
+ output_tokens?: number | null | undefined;
391
+ cached_input_tokens?: number | null | undefined;
392
+ } | undefined;
314
393
  observed_model?: string | null | undefined;
315
394
  outcome?: {
316
395
  status?: "failed" | "success" | "blocked" | "success_with_warnings" | undefined;
@@ -320,20 +399,22 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
320
399
  web_required_unsatisfied?: boolean | undefined;
321
400
  tool_warnings_count?: number | undefined;
322
401
  } | undefined;
402
+ requested_model?: string | null | undefined;
323
403
  auth_mode?: "unknown" | "api_key" | "local_session" | null | undefined;
404
+ auth_source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
324
405
  request_requirements?: {
325
406
  requested: boolean;
326
407
  effective: boolean;
327
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
328
408
  harness_id: string;
409
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
329
410
  eligible: boolean;
330
- capability: "browser";
411
+ capability: "browser" | "path_deny";
331
412
  evidence_refs?: string[] | undefined;
332
413
  }[] | undefined;
333
414
  tool_errors?: {
334
415
  summary: string;
335
416
  tool: string;
336
- kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
417
+ kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
337
418
  target?: string | null | undefined;
338
419
  recovered?: boolean | undefined;
339
420
  tool_use_id?: string | null | undefined;
@@ -413,29 +494,39 @@ export declare const RunTelemetry: z.ZodObject<{
413
494
  * unknown, never guess from manifests.
414
495
  */
415
496
  auth_mode: z.ZodDefault<z.ZodNullable<z.ZodEnum<["local_session", "api_key", "unknown"]>>>;
497
+ /** Concrete credential source the attempt disclosed alongside its route
498
+ * (route evidence; null = undisclosed, never guessed). */
499
+ auth_source: z.ZodDefault<z.ZodNullable<z.ZodEnum<["native_session", "oauth_token_env", "api_key_env", "api_key_flag", "provider_auth_file", "none"]>>>;
500
+ /** Credential profile the attempt ACTUALLY ran under (INV-135), from the
501
+ * adapter's per-event stamp; rotation makes this differ from the run's
502
+ * requested id. Null = engine-default credentials or never disclosed. */
503
+ profile_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
504
+ /** Model hint the engine actually SENT this attempt (requested side of the
505
+ * model x route truth; observed_model is the disclosed side). */
506
+ requested_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
416
507
  request_requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
417
- capability: z.ZodLiteral<"browser">;
508
+ capability: z.ZodEnum<["browser", "path_deny"]>;
418
509
  harness_id: z.ZodString;
419
510
  eligible: z.ZodBoolean;
420
511
  requested: z.ZodBoolean;
421
512
  effective: z.ZodBoolean;
422
- reason: z.ZodEnum<["not_requested", "effective", "manifest_unsupported", "web_policy_off", "access_profile_incompatible"]>;
513
+ reason: z.ZodEnum<["not_requested", "effective", "manifest_unsupported", "web_policy_off", "access_profile_incompatible", "postdiff_only"]>;
423
514
  evidence_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
424
515
  }, "strip", z.ZodTypeAny, {
425
516
  requested: boolean;
426
517
  effective: boolean;
427
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
428
- evidence_refs: string[];
429
518
  harness_id: string;
519
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
520
+ evidence_refs: string[];
430
521
  eligible: boolean;
431
- capability: "browser";
522
+ capability: "browser" | "path_deny";
432
523
  }, {
433
524
  requested: boolean;
434
525
  effective: boolean;
435
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
436
526
  harness_id: string;
527
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
437
528
  eligible: boolean;
438
- capability: "browser";
529
+ capability: "browser" | "path_deny";
439
530
  evidence_refs?: string[] | undefined;
440
531
  }>, "many">>;
441
532
  web: z.ZodObject<{
@@ -481,16 +572,16 @@ export declare const RunTelemetry: z.ZodObject<{
481
572
  recovered: z.ZodDefault<z.ZodBoolean>;
482
573
  tool_use_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
483
574
  }, "strip", z.ZodTypeAny, {
484
- kind: "file" | "web" | "command" | "mcp" | "search" | "other";
485
- summary: string;
575
+ kind: "web" | "file" | "command" | "mcp" | "search" | "other";
486
576
  target: string | null;
577
+ summary: string;
487
578
  tool: string;
488
579
  recovered: boolean;
489
580
  tool_use_id: string | null;
490
581
  }, {
491
582
  summary: string;
492
583
  tool: string;
493
- kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
584
+ kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
494
585
  target?: string | null | undefined;
495
586
  recovered?: boolean | undefined;
496
587
  tool_use_id?: string | null | undefined;
@@ -535,7 +626,22 @@ export declare const RunTelemetry: z.ZodObject<{
535
626
  web_required_unsatisfied?: boolean | undefined;
536
627
  tool_warnings_count?: number | undefined;
537
628
  }>>;
629
+ /** Token usage summed across this attempt's usage events. */
630
+ usage: z.ZodDefault<z.ZodObject<{
631
+ input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
632
+ output_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
633
+ cached_input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
634
+ }, "strip", z.ZodTypeAny, {
635
+ input_tokens: number | null;
636
+ output_tokens: number | null;
637
+ cached_input_tokens: number | null;
638
+ }, {
639
+ input_tokens?: number | null | undefined;
640
+ output_tokens?: number | null | undefined;
641
+ cached_input_tokens?: number | null | undefined;
642
+ }>>;
538
643
  }, "strip", z.ZodTypeAny, {
644
+ profile_id: string | null;
539
645
  harness_id: string;
540
646
  web: {
541
647
  status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
@@ -548,6 +654,11 @@ export declare const RunTelemetry: z.ZodObject<{
548
654
  attempted: boolean;
549
655
  satisfied: boolean;
550
656
  };
657
+ usage: {
658
+ input_tokens: number | null;
659
+ output_tokens: number | null;
660
+ cached_input_tokens: number | null;
661
+ };
551
662
  observed_model: string | null;
552
663
  attempt_id: string;
553
664
  outcome: {
@@ -558,20 +669,22 @@ export declare const RunTelemetry: z.ZodObject<{
558
669
  web_required_unsatisfied: boolean;
559
670
  tool_warnings_count: number;
560
671
  };
672
+ requested_model: string | null;
561
673
  auth_mode: "unknown" | "api_key" | "local_session" | null;
674
+ auth_source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
562
675
  request_requirements: {
563
676
  requested: boolean;
564
677
  effective: boolean;
565
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
566
- evidence_refs: string[];
567
678
  harness_id: string;
679
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
680
+ evidence_refs: string[];
568
681
  eligible: boolean;
569
- capability: "browser";
682
+ capability: "browser" | "path_deny";
570
683
  }[];
571
684
  tool_errors: {
572
- kind: "file" | "web" | "command" | "mcp" | "search" | "other";
573
- summary: string;
685
+ kind: "web" | "file" | "command" | "mcp" | "search" | "other";
574
686
  target: string | null;
687
+ summary: string;
575
688
  tool: string;
576
689
  recovered: boolean;
577
690
  tool_use_id: string | null;
@@ -598,6 +711,12 @@ export declare const RunTelemetry: z.ZodObject<{
598
711
  satisfied?: boolean | undefined;
599
712
  };
600
713
  attempt_id: string;
714
+ profile_id?: string | null | undefined;
715
+ usage?: {
716
+ input_tokens?: number | null | undefined;
717
+ output_tokens?: number | null | undefined;
718
+ cached_input_tokens?: number | null | undefined;
719
+ } | undefined;
601
720
  observed_model?: string | null | undefined;
602
721
  outcome?: {
603
722
  status?: "failed" | "success" | "blocked" | "success_with_warnings" | undefined;
@@ -607,20 +726,22 @@ export declare const RunTelemetry: z.ZodObject<{
607
726
  web_required_unsatisfied?: boolean | undefined;
608
727
  tool_warnings_count?: number | undefined;
609
728
  } | undefined;
729
+ requested_model?: string | null | undefined;
610
730
  auth_mode?: "unknown" | "api_key" | "local_session" | null | undefined;
731
+ auth_source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
611
732
  request_requirements?: {
612
733
  requested: boolean;
613
734
  effective: boolean;
614
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
615
735
  harness_id: string;
736
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
616
737
  eligible: boolean;
617
- capability: "browser";
738
+ capability: "browser" | "path_deny";
618
739
  evidence_refs?: string[] | undefined;
619
740
  }[] | undefined;
620
741
  tool_errors?: {
621
742
  summary: string;
622
743
  tool: string;
623
- kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
744
+ kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
624
745
  target?: string | null | undefined;
625
746
  recovered?: boolean | undefined;
626
747
  tool_use_id?: string | null | undefined;
@@ -635,37 +756,103 @@ export declare const RunTelemetry: z.ZodObject<{
635
756
  }[] | undefined;
636
757
  }>, "many">>;
637
758
  request_requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
638
- capability: z.ZodLiteral<"browser">;
759
+ capability: z.ZodEnum<["browser", "path_deny"]>;
639
760
  harness_id: z.ZodString;
640
761
  eligible: z.ZodBoolean;
641
762
  requested: z.ZodBoolean;
642
763
  effective: z.ZodBoolean;
643
- reason: z.ZodEnum<["not_requested", "effective", "manifest_unsupported", "web_policy_off", "access_profile_incompatible"]>;
764
+ reason: z.ZodEnum<["not_requested", "effective", "manifest_unsupported", "web_policy_off", "access_profile_incompatible", "postdiff_only"]>;
644
765
  evidence_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
645
766
  }, "strip", z.ZodTypeAny, {
646
767
  requested: boolean;
647
768
  effective: boolean;
648
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
649
- evidence_refs: string[];
650
769
  harness_id: string;
770
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
771
+ evidence_refs: string[];
651
772
  eligible: boolean;
652
- capability: "browser";
773
+ capability: "browser" | "path_deny";
653
774
  }, {
654
775
  requested: boolean;
655
776
  effective: boolean;
656
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
657
777
  harness_id: string;
778
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
658
779
  eligible: boolean;
659
- capability: "browser";
780
+ capability: "browser" | "path_deny";
660
781
  evidence_refs?: string[] | undefined;
661
782
  }>, "many">>;
662
783
  /** Sum of attempt outcome warnings; surfaces render this separately from terminal state. */
663
784
  tool_warnings_total: z.ZodDefault<z.ZodNumber>;
785
+ /** Token usage summed across every attempt (candidates + synthesis), the
786
+ * same accounting scope as spendUsd. Each field null until some attempt
787
+ * reports it. Not a grand total (see TokenUsage). */
788
+ usage_totals: z.ZodDefault<z.ZodObject<{
789
+ input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
790
+ output_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
791
+ cached_input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
792
+ }, "strip", z.ZodTypeAny, {
793
+ input_tokens: number | null;
794
+ output_tokens: number | null;
795
+ cached_input_tokens: number | null;
796
+ }, {
797
+ input_tokens?: number | null | undefined;
798
+ output_tokens?: number | null | undefined;
799
+ cached_input_tokens?: number | null | undefined;
800
+ }>>;
801
+ /** The run's auth ROUTE RECEIPT (INV-061 disclosure): requested preference,
802
+ * the effective route/source the deciding attempt disclosed, and a
803
+ * deterministic reason — computed ONCE here; summary/CLI project it
804
+ * verbatim. Null only on legacy artifacts written before this field. */
805
+ auth_route: z.ZodDefault<z.ZodNullable<z.ZodObject<{
806
+ requested: z.ZodEnum<["subscription", "api_key", "auto"]>;
807
+ effective: z.ZodDefault<z.ZodNullable<z.ZodEnum<["local_session", "api_key", "unknown"]>>>;
808
+ source: z.ZodDefault<z.ZodNullable<z.ZodEnum<["native_session", "oauth_token_env", "api_key_env", "api_key_flag", "provider_auth_file", "none"]>>>;
809
+ reason: z.ZodEnum<["as_requested", "native_first", "no_native_session_fallback", "requested_route_unavailable", "undisclosed"]>;
810
+ harness_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
811
+ attempt_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
812
+ /** Credential profile the deciding attempt ran under (INV-135);
813
+ * null = engine-default credentials. */
814
+ profile_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
815
+ /** Typed model mismatch on the deciding attempt (Quiz-2a): the engine
816
+ * SENT requested but the stream DISCLOSED observed. Null when they
817
+ * match or either side is unknown — never inferred. Distinct from the
818
+ * reviewer-panel same_model_fallback route proof. */
819
+ model_mismatch: z.ZodDefault<z.ZodNullable<z.ZodObject<{
820
+ requested: z.ZodString;
821
+ observed: z.ZodString;
822
+ }, "strip", z.ZodTypeAny, {
823
+ requested: string;
824
+ observed: string;
825
+ }, {
826
+ requested: string;
827
+ observed: string;
828
+ }>>>;
829
+ }, "strip", z.ZodTypeAny, {
830
+ source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
831
+ requested: "auto" | "subscription" | "api_key";
832
+ effective: "unknown" | "api_key" | "local_session" | null;
833
+ profile_id: string | null;
834
+ harness_id: string | null;
835
+ reason: "as_requested" | "native_first" | "no_native_session_fallback" | "requested_route_unavailable" | "undisclosed";
836
+ attempt_id: string | null;
837
+ model_mismatch: {
838
+ requested: string;
839
+ observed: string;
840
+ } | null;
841
+ }, {
842
+ requested: "auto" | "subscription" | "api_key";
843
+ reason: "as_requested" | "native_first" | "no_native_session_fallback" | "requested_route_unavailable" | "undisclosed";
844
+ source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
845
+ effective?: "unknown" | "api_key" | "local_session" | null | undefined;
846
+ profile_id?: string | null | undefined;
847
+ harness_id?: string | null | undefined;
848
+ attempt_id?: string | null | undefined;
849
+ model_mismatch?: {
850
+ requested: string;
851
+ observed: string;
852
+ } | null | undefined;
853
+ }>>>;
664
854
  generated_at: z.ZodString;
665
855
  }, "strip", z.ZodTypeAny, {
666
- mode: "ask" | "plan" | "audit" | "agent" | "orchestrate";
667
- schema_version: 2;
668
- external_context_policy: "off" | "auto" | "cached" | "live";
669
856
  web: {
670
857
  status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
671
858
  target: string | null;
@@ -677,10 +864,14 @@ export declare const RunTelemetry: z.ZodObject<{
677
864
  attempted: boolean;
678
865
  satisfied: boolean;
679
866
  };
867
+ mode: "ask" | "plan" | "audit" | "agent" | "orchestrate";
868
+ schema_version: 2;
869
+ external_context_policy: "off" | "auto" | "cached" | "live";
680
870
  run_id: string;
681
871
  task_id: string;
682
872
  web_required: boolean;
683
873
  attempts: {
874
+ profile_id: string | null;
684
875
  harness_id: string;
685
876
  web: {
686
877
  status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
@@ -693,6 +884,11 @@ export declare const RunTelemetry: z.ZodObject<{
693
884
  attempted: boolean;
694
885
  satisfied: boolean;
695
886
  };
887
+ usage: {
888
+ input_tokens: number | null;
889
+ output_tokens: number | null;
890
+ cached_input_tokens: number | null;
891
+ };
696
892
  observed_model: string | null;
697
893
  attempt_id: string;
698
894
  outcome: {
@@ -703,20 +899,22 @@ export declare const RunTelemetry: z.ZodObject<{
703
899
  web_required_unsatisfied: boolean;
704
900
  tool_warnings_count: number;
705
901
  };
902
+ requested_model: string | null;
706
903
  auth_mode: "unknown" | "api_key" | "local_session" | null;
904
+ auth_source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
707
905
  request_requirements: {
708
906
  requested: boolean;
709
907
  effective: boolean;
710
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
711
- evidence_refs: string[];
712
908
  harness_id: string;
909
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
910
+ evidence_refs: string[];
713
911
  eligible: boolean;
714
- capability: "browser";
912
+ capability: "browser" | "path_deny";
715
913
  }[];
716
914
  tool_errors: {
717
- kind: "file" | "web" | "command" | "mcp" | "search" | "other";
718
- summary: string;
915
+ kind: "web" | "file" | "command" | "mcp" | "search" | "other";
719
916
  target: string | null;
917
+ summary: string;
720
918
  tool: string;
721
919
  recovered: boolean;
722
920
  tool_use_id: string | null;
@@ -730,25 +928,40 @@ export declare const RunTelemetry: z.ZodObject<{
730
928
  retry_delay_ms: number | null;
731
929
  }[];
732
930
  }[];
931
+ generated_at: string;
733
932
  request_requirements: {
734
933
  requested: boolean;
735
934
  effective: boolean;
736
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
737
- evidence_refs: string[];
738
935
  harness_id: string;
936
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
937
+ evidence_refs: string[];
739
938
  eligible: boolean;
740
- capability: "browser";
939
+ capability: "browser" | "path_deny";
741
940
  }[];
742
941
  requested_access: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native";
743
942
  effective_access: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native";
744
943
  effective_web_mode: "off" | "auto" | "cached" | "live";
745
944
  final_attempt_id: string | null;
746
945
  tool_warnings_total: number;
747
- generated_at: string;
946
+ usage_totals: {
947
+ input_tokens: number | null;
948
+ output_tokens: number | null;
949
+ cached_input_tokens: number | null;
950
+ };
951
+ auth_route: {
952
+ source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
953
+ requested: "auto" | "subscription" | "api_key";
954
+ effective: "unknown" | "api_key" | "local_session" | null;
955
+ profile_id: string | null;
956
+ harness_id: string | null;
957
+ reason: "as_requested" | "native_first" | "no_native_session_fallback" | "requested_route_unavailable" | "undisclosed";
958
+ attempt_id: string | null;
959
+ model_mismatch: {
960
+ requested: string;
961
+ observed: string;
962
+ } | null;
963
+ } | null;
748
964
  }, {
749
- mode: "ask" | "plan" | "audit" | "agent" | "orchestrate";
750
- schema_version: 2;
751
- external_context_policy: "off" | "auto" | "cached" | "live";
752
965
  web: {
753
966
  status?: "failed" | "none" | "attempted" | "satisfied" | "unverified" | undefined;
754
967
  target?: string | null | undefined;
@@ -760,12 +973,15 @@ export declare const RunTelemetry: z.ZodObject<{
760
973
  attempted?: boolean | undefined;
761
974
  satisfied?: boolean | undefined;
762
975
  };
976
+ mode: "ask" | "plan" | "audit" | "agent" | "orchestrate";
977
+ schema_version: 2;
978
+ external_context_policy: "off" | "auto" | "cached" | "live";
763
979
  run_id: string;
764
980
  task_id: string;
981
+ generated_at: string;
765
982
  requested_access: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native";
766
983
  effective_access: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native";
767
984
  effective_web_mode: "off" | "auto" | "cached" | "live";
768
- generated_at: string;
769
985
  web_required?: boolean | undefined;
770
986
  attempts?: {
771
987
  harness_id: string;
@@ -781,6 +997,12 @@ export declare const RunTelemetry: z.ZodObject<{
781
997
  satisfied?: boolean | undefined;
782
998
  };
783
999
  attempt_id: string;
1000
+ profile_id?: string | null | undefined;
1001
+ usage?: {
1002
+ input_tokens?: number | null | undefined;
1003
+ output_tokens?: number | null | undefined;
1004
+ cached_input_tokens?: number | null | undefined;
1005
+ } | undefined;
784
1006
  observed_model?: string | null | undefined;
785
1007
  outcome?: {
786
1008
  status?: "failed" | "success" | "blocked" | "success_with_warnings" | undefined;
@@ -790,20 +1012,22 @@ export declare const RunTelemetry: z.ZodObject<{
790
1012
  web_required_unsatisfied?: boolean | undefined;
791
1013
  tool_warnings_count?: number | undefined;
792
1014
  } | undefined;
1015
+ requested_model?: string | null | undefined;
793
1016
  auth_mode?: "unknown" | "api_key" | "local_session" | null | undefined;
1017
+ auth_source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
794
1018
  request_requirements?: {
795
1019
  requested: boolean;
796
1020
  effective: boolean;
797
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
798
1021
  harness_id: string;
1022
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
799
1023
  eligible: boolean;
800
- capability: "browser";
1024
+ capability: "browser" | "path_deny";
801
1025
  evidence_refs?: string[] | undefined;
802
1026
  }[] | undefined;
803
1027
  tool_errors?: {
804
1028
  summary: string;
805
1029
  tool: string;
806
- kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
1030
+ kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
807
1031
  target?: string | null | undefined;
808
1032
  recovered?: boolean | undefined;
809
1033
  tool_use_id?: string | null | undefined;
@@ -820,14 +1044,32 @@ export declare const RunTelemetry: z.ZodObject<{
820
1044
  request_requirements?: {
821
1045
  requested: boolean;
822
1046
  effective: boolean;
823
- reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible";
824
1047
  harness_id: string;
1048
+ reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
825
1049
  eligible: boolean;
826
- capability: "browser";
1050
+ capability: "browser" | "path_deny";
827
1051
  evidence_refs?: string[] | undefined;
828
1052
  }[] | undefined;
829
1053
  final_attempt_id?: string | null | undefined;
830
1054
  tool_warnings_total?: number | undefined;
1055
+ usage_totals?: {
1056
+ input_tokens?: number | null | undefined;
1057
+ output_tokens?: number | null | undefined;
1058
+ cached_input_tokens?: number | null | undefined;
1059
+ } | undefined;
1060
+ auth_route?: {
1061
+ requested: "auto" | "subscription" | "api_key";
1062
+ reason: "as_requested" | "native_first" | "no_native_session_fallback" | "requested_route_unavailable" | "undisclosed";
1063
+ source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
1064
+ effective?: "unknown" | "api_key" | "local_session" | null | undefined;
1065
+ profile_id?: string | null | undefined;
1066
+ harness_id?: string | null | undefined;
1067
+ attempt_id?: string | null | undefined;
1068
+ model_mismatch?: {
1069
+ requested: string;
1070
+ observed: string;
1071
+ } | null | undefined;
1072
+ } | null | undefined;
831
1073
  }>;
832
1074
  export type RunTelemetry = z.infer<typeof RunTelemetry>;
833
1075
  //# sourceMappingURL=telemetry.d.ts.map