@tellagen/mcp-server 0.5.1 → 0.7.0

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 (123) hide show
  1. package/README.md +53 -3
  2. package/SKILL.md +143 -19
  3. package/contracts/mcp-protocol.json +64 -3
  4. package/contracts/runbooks/manifest.json +24 -14
  5. package/contracts/runbooks/v2/client-protocol.json +65 -2
  6. package/contracts/runbooks/v2/client-writes.guidance.json +16 -1
  7. package/contracts/runbooks/v2/fixtures/filesystem-pressure.json +22 -31
  8. package/contracts/runbooks/v2/fixtures/timeline-event-blocks-rejected.json +15 -1
  9. package/contracts/runbooks/v2/investigation-window.guidance.json +45 -0
  10. package/contracts/runbooks/v2/question-checks.guidance.json +49 -0
  11. package/contracts/runbooks/v2/result-summary.guidance.json +53 -5
  12. package/contracts/runbooks/v2/timeline-event-blocks.schema.json +66 -3
  13. package/contracts/tellagen-runbook-contracts.json +3 -3
  14. package/dist/active-run.d.ts +6 -0
  15. package/dist/active-run.js +14 -0
  16. package/dist/active-run.js.map +1 -1
  17. package/dist/cli/doctor.d.ts +19 -0
  18. package/dist/cli/doctor.js +179 -0
  19. package/dist/cli/doctor.js.map +1 -0
  20. package/dist/cli/kubernetes.d.ts +47 -0
  21. package/dist/cli/kubernetes.js +369 -0
  22. package/dist/cli/kubernetes.js.map +1 -0
  23. package/dist/cli/main.js +10 -0
  24. package/dist/cli/main.js.map +1 -1
  25. package/dist/diagnosis-structure.d.ts +380 -102
  26. package/dist/diagnosis-structure.js +334 -14
  27. package/dist/diagnosis-structure.js.map +1 -1
  28. package/dist/doctor/checks.d.ts +42 -0
  29. package/dist/doctor/checks.js +181 -0
  30. package/dist/doctor/checks.js.map +1 -0
  31. package/dist/doctor/config-files.d.ts +49 -0
  32. package/dist/doctor/config-files.js +121 -0
  33. package/dist/doctor/config-files.js.map +1 -0
  34. package/dist/doctor/k8s-read-only.d.ts +16 -0
  35. package/dist/doctor/k8s-read-only.js +89 -0
  36. package/dist/doctor/k8s-read-only.js.map +1 -0
  37. package/dist/doctor/real-fs.d.ts +3 -0
  38. package/dist/doctor/real-fs.js +36 -0
  39. package/dist/doctor/real-fs.js.map +1 -0
  40. package/dist/doctor/toml.d.ts +13 -0
  41. package/dist/doctor/toml.js +205 -0
  42. package/dist/doctor/toml.js.map +1 -0
  43. package/dist/figures.d.ts +520 -101
  44. package/dist/figures.js +341 -7
  45. package/dist/figures.js.map +1 -1
  46. package/dist/heartbeat.d.ts +3 -0
  47. package/dist/heartbeat.js +32 -1
  48. package/dist/heartbeat.js.map +1 -1
  49. package/dist/index.js +1 -1
  50. package/dist/index.js.map +1 -1
  51. package/dist/k8s-safety.d.ts +42 -0
  52. package/dist/k8s-safety.js +33 -0
  53. package/dist/k8s-safety.js.map +1 -0
  54. package/dist/listen-config.d.ts +5 -5
  55. package/dist/listen-probe.d.ts +14 -1
  56. package/dist/listen-probe.js +83 -5
  57. package/dist/listen-probe.js.map +1 -1
  58. package/dist/listen-settings.d.ts +8 -0
  59. package/dist/listen-settings.js +29 -0
  60. package/dist/listen-settings.js.map +1 -1
  61. package/dist/listener.d.ts +11 -0
  62. package/dist/listener.js +60 -16
  63. package/dist/listener.js.map +1 -1
  64. package/dist/log-lines.d.ts +118 -0
  65. package/dist/log-lines.js +534 -0
  66. package/dist/log-lines.js.map +1 -0
  67. package/dist/redact.d.ts +21 -0
  68. package/dist/redact.js +212 -5
  69. package/dist/redact.js.map +1 -1
  70. package/dist/run-events.js +13 -1
  71. package/dist/run-events.js.map +1 -1
  72. package/dist/run-requests.d.ts +16 -0
  73. package/dist/run-requests.js +56 -0
  74. package/dist/run-requests.js.map +1 -0
  75. package/dist/run-window.d.ts +59 -0
  76. package/dist/run-window.js +141 -0
  77. package/dist/run-window.js.map +1 -0
  78. package/dist/server.d.ts +1 -1
  79. package/dist/server.js +11 -9
  80. package/dist/server.js.map +1 -1
  81. package/dist/session.d.ts +37 -0
  82. package/dist/session.js +59 -0
  83. package/dist/session.js.map +1 -1
  84. package/dist/tool-report.d.ts +2 -0
  85. package/dist/tool-report.js +3 -0
  86. package/dist/tool-report.js.map +1 -0
  87. package/dist/tools/amendments.d.ts +13 -0
  88. package/dist/tools/amendments.js +206 -0
  89. package/dist/tools/amendments.js.map +1 -0
  90. package/dist/tools/catalog.js +4 -0
  91. package/dist/tools/catalog.js.map +1 -1
  92. package/dist/tools/diagnostics.js +131 -3
  93. package/dist/tools/diagnostics.js.map +1 -1
  94. package/dist/tools/figures.d.ts +2 -2
  95. package/dist/tools/figures.js +37 -9
  96. package/dist/tools/figures.js.map +1 -1
  97. package/dist/tools/findings.d.ts +136 -0
  98. package/dist/tools/findings.js +68 -7
  99. package/dist/tools/findings.js.map +1 -1
  100. package/dist/tools/index.js +4 -0
  101. package/dist/tools/index.js.map +1 -1
  102. package/dist/tools/investigations.d.ts +3223 -5
  103. package/dist/tools/investigations.js +202 -50
  104. package/dist/tools/investigations.js.map +1 -1
  105. package/dist/tools/next.d.ts +16 -0
  106. package/dist/tools/next.js +49 -1
  107. package/dist/tools/next.js.map +1 -1
  108. package/dist/tools/postmortem-runbooks.d.ts +20 -20
  109. package/dist/tools/requests.d.ts +3 -0
  110. package/dist/tools/requests.js +62 -0
  111. package/dist/tools/requests.js.map +1 -0
  112. package/dist/tools/resume.js +14 -1
  113. package/dist/tools/resume.js.map +1 -1
  114. package/dist/tools/source-links.d.ts +7 -0
  115. package/dist/tools/source-links.js +32 -5
  116. package/dist/tools/source-links.js.map +1 -1
  117. package/dist/tools/timeline.js +24 -2
  118. package/dist/tools/timeline.js.map +1 -1
  119. package/dist/version.d.ts +4 -2
  120. package/dist/version.js +6 -1
  121. package/dist/version.js.map +1 -1
  122. package/package.json +1 -1
  123. package/server.json +1 -1
@@ -17,7 +17,8 @@
17
17
  */
18
18
  import { z } from "zod";
19
19
  import type { TellagenClient } from "./client.js";
20
- import { FIGURE_EXTRAS_CAPABILITY } from "./figures.js";
20
+ import { FIGURE_EXTRAS_CAPABILITY, FIGURE_LIMITS_CAPABILITY } from "./figures.js";
21
+ import { type RunWindow } from "./run-window.js";
21
22
  import { RECORDED_STEPS_CAPABILITY } from "./trace-record.js";
22
23
  export { RECORDED_STEPS_CAPABILITY };
23
24
  export declare const DIAGNOSIS_STRUCTURE_CAPABILITY = "diagnosis_structure_v1";
@@ -27,7 +28,20 @@ export declare const DIAGNOSIS_CHANGES_CAPABILITY = "diagnosis_changes_v1";
27
28
  export declare const RUN_IMAGES_CAPABILITY = "run_images_v1";
28
29
  /** The server takes unchanged lines and line numbers in a diff figure. */
29
30
  export declare const DIFF_LINES_CAPABILITY = "diff_lines_v1";
30
- export { FIGURE_EXTRAS_CAPABILITY };
31
+ /** The server takes a log_lines figure. */
32
+ export declare const LOG_LINES_CAPABILITY = "log_lines_v1";
33
+ export { FIGURE_EXTRAS_CAPABILITY, FIGURE_LIMITS_CAPABILITY };
34
+ /** result_summary.answer and a figure on a recommended action. */
35
+ export declare const ACTION_ANSWER_CAPABILITY = "action_answer_v1";
36
+ /** result_summary.alert_verdict: the verdict on the alert behind the incident, and its proof checklist. */
37
+ export declare const ALERT_VERDICT_CAPABILITY = "alert_verdict_v1";
38
+ /**
39
+ * The capability of a Tellagen that takes additions to a finished run and the
40
+ * reason, retryable and detail of a coverage entry (both ship together).
41
+ */
42
+ export declare const RUN_AMENDMENTS_CAPABILITY = "run_amendments_v1";
43
+ /** A coverage entry may have the state not_needed. */
44
+ export declare const COVERAGE_NOT_NEEDED_CAPABILITY = "coverage_not_needed_v1";
31
45
  /**
32
46
  * Remembers the capabilities the backend that answered a pickup or context
33
47
  * call for `runId` advertises. A missing `server_capabilities` is a definite
@@ -53,6 +67,29 @@ export declare function supportsDiffLines(client: TellagenClient, runId?: string
53
67
  * runs_not_shown. Decided like supportsDiffLines.
54
68
  */
55
69
  export declare function supportsFigureExtras(client: TellagenClient, runId?: string): Promise<boolean>;
70
+ /** Whether the backend takes a `limit` on a compare row. Decided like supportsDiffLines. */
71
+ export declare function supportsFigureLimits(client: TellagenClient, runId?: string): Promise<boolean>;
72
+ /** Whether the backend takes result_summary.answer and a figure on a recommended action. */
73
+ export declare function supportsActionAnswer(client: TellagenClient, runId: string): Promise<boolean>;
74
+ /** Whether the backend takes result_summary.alert_verdict. Listed only for a run whose incident came from an alert. */
75
+ export declare function supportsAlertVerdict(client: TellagenClient, runId: string): Promise<boolean>;
76
+ /** Whether the backend takes additions to a finished run and coverage reasons. */
77
+ export declare function supportsRunAmendments(client: TellagenClient, runId: string): Promise<boolean>;
78
+ /** Whether the backend takes the coverage state not_needed. */
79
+ export declare function supportsCoverageNotNeeded(client: TellagenClient, runId: string): Promise<boolean>;
80
+ /**
81
+ * Whether the backend takes a log_lines figure. Decided like supportsDiffLines:
82
+ * with a run id it asks for that run, otherwise the latest pickup of this
83
+ * process decides, and with no pickup yet the answer is no.
84
+ */
85
+ export declare function supportsLogLines(client: TellagenClient, runId?: string): Promise<boolean>;
86
+ /**
87
+ * The time window of the run, from its pickup or its context. A run this
88
+ * process did not pick up is read once through the context. Undefined for a
89
+ * run with no window (an older Tellagen, a run made before windows) and when
90
+ * the lookup fails.
91
+ */
92
+ export declare function runWindowOf(client: TellagenClient, runId: string | undefined): Promise<RunWindow | undefined>;
56
93
  /** The capability a Tellagen can list to say that it answers a completion dry run. */
57
94
  export declare const COMPLETION_REPAIRS_CAPABILITY = "completion_repairs_v1";
58
95
  /**
@@ -79,11 +116,11 @@ export declare const evidenceLinkSchema: z.ZodObject<{
79
116
  label: z.ZodString;
80
117
  url: z.ZodEffects<z.ZodString, string, string>;
81
118
  }, "strip", z.ZodTypeAny, {
82
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
119
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
83
120
  label: string;
84
121
  url: string;
85
122
  }, {
86
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
123
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
87
124
  label: string;
88
125
  url: string;
89
126
  }>;
@@ -92,11 +129,11 @@ export declare const evidenceLinksSchema: z.ZodArray<z.ZodObject<{
92
129
  label: z.ZodString;
93
130
  url: z.ZodEffects<z.ZodString, string, string>;
94
131
  }, "strip", z.ZodTypeAny, {
95
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
132
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
96
133
  label: string;
97
134
  url: string;
98
135
  }, {
99
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
136
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
100
137
  label: string;
101
138
  url: string;
102
139
  }>, "many">;
@@ -107,11 +144,11 @@ export declare const evidenceRefStructureShape: {
107
144
  label: z.ZodString;
108
145
  url: z.ZodEffects<z.ZodString, string, string>;
109
146
  }, "strip", z.ZodTypeAny, {
110
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
147
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
111
148
  label: string;
112
149
  url: string;
113
150
  }, {
114
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
151
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
115
152
  label: string;
116
153
  url: string;
117
154
  }>, "many">>;
@@ -130,12 +167,12 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
130
167
  value: string;
131
168
  label: string;
132
169
  caption?: string | undefined;
133
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
170
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
134
171
  }, {
135
172
  value: string;
136
173
  label: string;
137
174
  caption?: string | undefined;
138
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
175
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
139
176
  }>, "many">;
140
177
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
141
178
  anchor: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -147,7 +184,7 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
147
184
  value: string;
148
185
  label: string;
149
186
  caption?: string | undefined;
150
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
187
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
151
188
  }[];
152
189
  anchor?: string | undefined;
153
190
  postmortem?: boolean | undefined;
@@ -158,7 +195,7 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
158
195
  value: string;
159
196
  label: string;
160
197
  caption?: string | undefined;
161
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
198
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
162
199
  }[];
163
200
  anchor?: string | undefined;
164
201
  postmortem?: boolean | undefined;
@@ -180,11 +217,12 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
180
217
  value: number;
181
218
  label?: string | undefined;
182
219
  }>>;
183
- rows: z.ZodArray<z.ZodObject<{
220
+ rows: z.ZodArray<z.ZodEffects<z.ZodObject<{
184
221
  label: z.ZodEffects<z.ZodString, string, string>;
185
222
  mono: z.ZodOptional<z.ZodBoolean>;
186
- before: z.ZodNumber;
223
+ before: z.ZodOptional<z.ZodNumber>;
187
224
  after: z.ZodNumber;
225
+ limit: z.ZodOptional<z.ZodNumber>;
188
226
  details: z.ZodOptional<z.ZodArray<z.ZodObject<{
189
227
  label: z.ZodEffects<z.ZodString, string, string>;
190
228
  before: z.ZodEffects<z.ZodString, string, string>;
@@ -200,7 +238,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
200
238
  }>, "many">>;
201
239
  }, "strict", z.ZodTypeAny, {
202
240
  label: string;
203
- before: number;
204
241
  after: number;
205
242
  details?: {
206
243
  label: string;
@@ -208,9 +245,32 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
208
245
  after: string;
209
246
  }[] | undefined;
210
247
  mono?: boolean | undefined;
248
+ before?: number | undefined;
249
+ limit?: number | undefined;
250
+ }, {
251
+ label: string;
252
+ after: number;
253
+ details?: {
254
+ label: string;
255
+ before: string;
256
+ after: string;
257
+ }[] | undefined;
258
+ mono?: boolean | undefined;
259
+ before?: number | undefined;
260
+ limit?: number | undefined;
261
+ }>, {
262
+ label: string;
263
+ after: number;
264
+ details?: {
265
+ label: string;
266
+ before: string;
267
+ after: string;
268
+ }[] | undefined;
269
+ mono?: boolean | undefined;
270
+ before?: number | undefined;
271
+ limit?: number | undefined;
211
272
  }, {
212
273
  label: string;
213
- before: number;
214
274
  after: number;
215
275
  details?: {
216
276
  label: string;
@@ -218,6 +278,8 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
218
278
  after: string;
219
279
  }[] | undefined;
220
280
  mono?: boolean | undefined;
281
+ before?: number | undefined;
282
+ limit?: number | undefined;
221
283
  }>, "many">;
222
284
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
223
285
  anchor: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -227,7 +289,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
227
289
  type: "compare";
228
290
  rows: {
229
291
  label: string;
230
- before: number;
231
292
  after: number;
232
293
  details?: {
233
294
  label: string;
@@ -235,6 +296,8 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
235
296
  after: string;
236
297
  }[] | undefined;
237
298
  mono?: boolean | undefined;
299
+ before?: number | undefined;
300
+ limit?: number | undefined;
238
301
  }[];
239
302
  title?: string | undefined;
240
303
  anchor?: string | undefined;
@@ -253,7 +316,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
253
316
  type: "compare";
254
317
  rows: {
255
318
  label: string;
256
- before: number;
257
319
  after: number;
258
320
  details?: {
259
321
  label: string;
@@ -261,6 +323,8 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
261
323
  after: string;
262
324
  }[] | undefined;
263
325
  mono?: boolean | undefined;
326
+ before?: number | undefined;
327
+ limit?: number | undefined;
264
328
  }[];
265
329
  title?: string | undefined;
266
330
  anchor?: string | undefined;
@@ -313,17 +377,17 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
313
377
  }, "strict", z.ZodTypeAny, {
314
378
  datasource?: string | undefined;
315
379
  kind?: string | undefined;
316
- query?: string | undefined;
317
380
  from?: string | undefined;
318
381
  to?: string | undefined;
382
+ query?: string | undefined;
319
383
  step?: string | undefined;
320
384
  artifact_id?: string | undefined;
321
385
  }, {
322
386
  datasource?: string | undefined;
323
387
  kind?: string | undefined;
324
- query?: string | undefined;
325
388
  from?: string | undefined;
326
389
  to?: string | undefined;
390
+ query?: string | undefined;
327
391
  step?: string | undefined;
328
392
  artifact_id?: string | undefined;
329
393
  }>>;
@@ -339,9 +403,9 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
339
403
  source?: {
340
404
  datasource?: string | undefined;
341
405
  kind?: string | undefined;
342
- query?: string | undefined;
343
406
  from?: string | undefined;
344
407
  to?: string | undefined;
408
+ query?: string | undefined;
345
409
  step?: string | undefined;
346
410
  artifact_id?: string | undefined;
347
411
  } | undefined;
@@ -367,9 +431,9 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
367
431
  source?: {
368
432
  datasource?: string | undefined;
369
433
  kind?: string | undefined;
370
- query?: string | undefined;
371
434
  from?: string | undefined;
372
435
  to?: string | undefined;
436
+ query?: string | undefined;
373
437
  step?: string | undefined;
374
438
  artifact_id?: string | undefined;
375
439
  } | undefined;
@@ -388,18 +452,18 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
388
452
  }[] | undefined;
389
453
  slot?: "summary" | undefined;
390
454
  }>, z.ZodObject<{
391
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
455
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
392
456
  }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
393
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
457
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
394
458
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
395
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
459
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
396
460
  }, z.ZodTypeAny, "passthrough">>]>, {
397
461
  type: "stats";
398
462
  items: {
399
463
  value: string;
400
464
  label: string;
401
465
  caption?: string | undefined;
402
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
466
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
403
467
  }[];
404
468
  anchor?: string | undefined;
405
469
  postmortem?: boolean | undefined;
@@ -408,7 +472,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
408
472
  type: "compare";
409
473
  rows: {
410
474
  label: string;
411
- before: number;
412
475
  after: number;
413
476
  details?: {
414
477
  label: string;
@@ -416,6 +479,8 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
416
479
  after: string;
417
480
  }[] | undefined;
418
481
  mono?: boolean | undefined;
482
+ before?: number | undefined;
483
+ limit?: number | undefined;
419
484
  }[];
420
485
  title?: string | undefined;
421
486
  anchor?: string | undefined;
@@ -438,9 +503,9 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
438
503
  source?: {
439
504
  datasource?: string | undefined;
440
505
  kind?: string | undefined;
441
- query?: string | undefined;
442
506
  from?: string | undefined;
443
507
  to?: string | undefined;
508
+ query?: string | undefined;
444
509
  step?: string | undefined;
445
510
  artifact_id?: string | undefined;
446
511
  } | undefined;
@@ -459,14 +524,14 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
459
524
  }[] | undefined;
460
525
  slot?: "summary" | undefined;
461
526
  } | z.objectOutputType<{
462
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
527
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
463
528
  }, z.ZodTypeAny, "passthrough">, {
464
529
  type: "stats";
465
530
  items: {
466
531
  value: string;
467
532
  label: string;
468
533
  caption?: string | undefined;
469
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
534
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
470
535
  }[];
471
536
  anchor?: string | undefined;
472
537
  postmortem?: boolean | undefined;
@@ -475,7 +540,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
475
540
  type: "compare";
476
541
  rows: {
477
542
  label: string;
478
- before: number;
479
543
  after: number;
480
544
  details?: {
481
545
  label: string;
@@ -483,6 +547,8 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
483
547
  after: string;
484
548
  }[] | undefined;
485
549
  mono?: boolean | undefined;
550
+ before?: number | undefined;
551
+ limit?: number | undefined;
486
552
  }[];
487
553
  title?: string | undefined;
488
554
  anchor?: string | undefined;
@@ -505,9 +571,9 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
505
571
  source?: {
506
572
  datasource?: string | undefined;
507
573
  kind?: string | undefined;
508
- query?: string | undefined;
509
574
  from?: string | undefined;
510
575
  to?: string | undefined;
576
+ query?: string | undefined;
511
577
  step?: string | undefined;
512
578
  artifact_id?: string | undefined;
513
579
  } | undefined;
@@ -526,7 +592,7 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
526
592
  }[] | undefined;
527
593
  slot?: "summary" | undefined;
528
594
  } | z.objectInputType<{
529
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
595
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
530
596
  }, z.ZodTypeAny, "passthrough">>;
531
597
  export declare const stepStructureShape: {
532
598
  finding_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
@@ -540,12 +606,12 @@ export declare const stepStructureShape: {
540
606
  value: string;
541
607
  label: string;
542
608
  caption?: string | undefined;
543
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
609
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
544
610
  }, {
545
611
  value: string;
546
612
  label: string;
547
613
  caption?: string | undefined;
548
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
614
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
549
615
  }>, "many">;
550
616
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
551
617
  anchor: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -557,7 +623,7 @@ export declare const stepStructureShape: {
557
623
  value: string;
558
624
  label: string;
559
625
  caption?: string | undefined;
560
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
626
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
561
627
  }[];
562
628
  anchor?: string | undefined;
563
629
  postmortem?: boolean | undefined;
@@ -568,7 +634,7 @@ export declare const stepStructureShape: {
568
634
  value: string;
569
635
  label: string;
570
636
  caption?: string | undefined;
571
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
637
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
572
638
  }[];
573
639
  anchor?: string | undefined;
574
640
  postmortem?: boolean | undefined;
@@ -590,11 +656,12 @@ export declare const stepStructureShape: {
590
656
  value: number;
591
657
  label?: string | undefined;
592
658
  }>>;
593
- rows: z.ZodArray<z.ZodObject<{
659
+ rows: z.ZodArray<z.ZodEffects<z.ZodObject<{
594
660
  label: z.ZodEffects<z.ZodString, string, string>;
595
661
  mono: z.ZodOptional<z.ZodBoolean>;
596
- before: z.ZodNumber;
662
+ before: z.ZodOptional<z.ZodNumber>;
597
663
  after: z.ZodNumber;
664
+ limit: z.ZodOptional<z.ZodNumber>;
598
665
  details: z.ZodOptional<z.ZodArray<z.ZodObject<{
599
666
  label: z.ZodEffects<z.ZodString, string, string>;
600
667
  before: z.ZodEffects<z.ZodString, string, string>;
@@ -610,7 +677,6 @@ export declare const stepStructureShape: {
610
677
  }>, "many">>;
611
678
  }, "strict", z.ZodTypeAny, {
612
679
  label: string;
613
- before: number;
614
680
  after: number;
615
681
  details?: {
616
682
  label: string;
@@ -618,9 +684,10 @@ export declare const stepStructureShape: {
618
684
  after: string;
619
685
  }[] | undefined;
620
686
  mono?: boolean | undefined;
687
+ before?: number | undefined;
688
+ limit?: number | undefined;
621
689
  }, {
622
690
  label: string;
623
- before: number;
624
691
  after: number;
625
692
  details?: {
626
693
  label: string;
@@ -628,6 +695,30 @@ export declare const stepStructureShape: {
628
695
  after: string;
629
696
  }[] | undefined;
630
697
  mono?: boolean | undefined;
698
+ before?: number | undefined;
699
+ limit?: number | undefined;
700
+ }>, {
701
+ label: string;
702
+ after: number;
703
+ details?: {
704
+ label: string;
705
+ before: string;
706
+ after: string;
707
+ }[] | undefined;
708
+ mono?: boolean | undefined;
709
+ before?: number | undefined;
710
+ limit?: number | undefined;
711
+ }, {
712
+ label: string;
713
+ after: number;
714
+ details?: {
715
+ label: string;
716
+ before: string;
717
+ after: string;
718
+ }[] | undefined;
719
+ mono?: boolean | undefined;
720
+ before?: number | undefined;
721
+ limit?: number | undefined;
631
722
  }>, "many">;
632
723
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
633
724
  anchor: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -637,7 +728,6 @@ export declare const stepStructureShape: {
637
728
  type: "compare";
638
729
  rows: {
639
730
  label: string;
640
- before: number;
641
731
  after: number;
642
732
  details?: {
643
733
  label: string;
@@ -645,6 +735,8 @@ export declare const stepStructureShape: {
645
735
  after: string;
646
736
  }[] | undefined;
647
737
  mono?: boolean | undefined;
738
+ before?: number | undefined;
739
+ limit?: number | undefined;
648
740
  }[];
649
741
  title?: string | undefined;
650
742
  anchor?: string | undefined;
@@ -663,7 +755,6 @@ export declare const stepStructureShape: {
663
755
  type: "compare";
664
756
  rows: {
665
757
  label: string;
666
- before: number;
667
758
  after: number;
668
759
  details?: {
669
760
  label: string;
@@ -671,6 +762,8 @@ export declare const stepStructureShape: {
671
762
  after: string;
672
763
  }[] | undefined;
673
764
  mono?: boolean | undefined;
765
+ before?: number | undefined;
766
+ limit?: number | undefined;
674
767
  }[];
675
768
  title?: string | undefined;
676
769
  anchor?: string | undefined;
@@ -723,17 +816,17 @@ export declare const stepStructureShape: {
723
816
  }, "strict", z.ZodTypeAny, {
724
817
  datasource?: string | undefined;
725
818
  kind?: string | undefined;
726
- query?: string | undefined;
727
819
  from?: string | undefined;
728
820
  to?: string | undefined;
821
+ query?: string | undefined;
729
822
  step?: string | undefined;
730
823
  artifact_id?: string | undefined;
731
824
  }, {
732
825
  datasource?: string | undefined;
733
826
  kind?: string | undefined;
734
- query?: string | undefined;
735
827
  from?: string | undefined;
736
828
  to?: string | undefined;
829
+ query?: string | undefined;
737
830
  step?: string | undefined;
738
831
  artifact_id?: string | undefined;
739
832
  }>>;
@@ -749,9 +842,9 @@ export declare const stepStructureShape: {
749
842
  source?: {
750
843
  datasource?: string | undefined;
751
844
  kind?: string | undefined;
752
- query?: string | undefined;
753
845
  from?: string | undefined;
754
846
  to?: string | undefined;
847
+ query?: string | undefined;
755
848
  step?: string | undefined;
756
849
  artifact_id?: string | undefined;
757
850
  } | undefined;
@@ -777,9 +870,9 @@ export declare const stepStructureShape: {
777
870
  source?: {
778
871
  datasource?: string | undefined;
779
872
  kind?: string | undefined;
780
- query?: string | undefined;
781
873
  from?: string | undefined;
782
874
  to?: string | undefined;
875
+ query?: string | undefined;
783
876
  step?: string | undefined;
784
877
  artifact_id?: string | undefined;
785
878
  } | undefined;
@@ -798,18 +891,18 @@ export declare const stepStructureShape: {
798
891
  }[] | undefined;
799
892
  slot?: "summary" | undefined;
800
893
  }>, z.ZodObject<{
801
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
894
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
802
895
  }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
803
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
896
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
804
897
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
805
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
898
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
806
899
  }, z.ZodTypeAny, "passthrough">>]>, {
807
900
  type: "stats";
808
901
  items: {
809
902
  value: string;
810
903
  label: string;
811
904
  caption?: string | undefined;
812
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
905
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
813
906
  }[];
814
907
  anchor?: string | undefined;
815
908
  postmortem?: boolean | undefined;
@@ -818,7 +911,6 @@ export declare const stepStructureShape: {
818
911
  type: "compare";
819
912
  rows: {
820
913
  label: string;
821
- before: number;
822
914
  after: number;
823
915
  details?: {
824
916
  label: string;
@@ -826,6 +918,8 @@ export declare const stepStructureShape: {
826
918
  after: string;
827
919
  }[] | undefined;
828
920
  mono?: boolean | undefined;
921
+ before?: number | undefined;
922
+ limit?: number | undefined;
829
923
  }[];
830
924
  title?: string | undefined;
831
925
  anchor?: string | undefined;
@@ -848,9 +942,9 @@ export declare const stepStructureShape: {
848
942
  source?: {
849
943
  datasource?: string | undefined;
850
944
  kind?: string | undefined;
851
- query?: string | undefined;
852
945
  from?: string | undefined;
853
946
  to?: string | undefined;
947
+ query?: string | undefined;
854
948
  step?: string | undefined;
855
949
  artifact_id?: string | undefined;
856
950
  } | undefined;
@@ -869,14 +963,14 @@ export declare const stepStructureShape: {
869
963
  }[] | undefined;
870
964
  slot?: "summary" | undefined;
871
965
  } | z.objectOutputType<{
872
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
966
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
873
967
  }, z.ZodTypeAny, "passthrough">, {
874
968
  type: "stats";
875
969
  items: {
876
970
  value: string;
877
971
  label: string;
878
972
  caption?: string | undefined;
879
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
973
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
880
974
  }[];
881
975
  anchor?: string | undefined;
882
976
  postmortem?: boolean | undefined;
@@ -885,7 +979,6 @@ export declare const stepStructureShape: {
885
979
  type: "compare";
886
980
  rows: {
887
981
  label: string;
888
- before: number;
889
982
  after: number;
890
983
  details?: {
891
984
  label: string;
@@ -893,6 +986,8 @@ export declare const stepStructureShape: {
893
986
  after: string;
894
987
  }[] | undefined;
895
988
  mono?: boolean | undefined;
989
+ before?: number | undefined;
990
+ limit?: number | undefined;
896
991
  }[];
897
992
  title?: string | undefined;
898
993
  anchor?: string | undefined;
@@ -915,9 +1010,9 @@ export declare const stepStructureShape: {
915
1010
  source?: {
916
1011
  datasource?: string | undefined;
917
1012
  kind?: string | undefined;
918
- query?: string | undefined;
919
1013
  from?: string | undefined;
920
1014
  to?: string | undefined;
1015
+ query?: string | undefined;
921
1016
  step?: string | undefined;
922
1017
  artifact_id?: string | undefined;
923
1018
  } | undefined;
@@ -936,18 +1031,18 @@ export declare const stepStructureShape: {
936
1031
  }[] | undefined;
937
1032
  slot?: "summary" | undefined;
938
1033
  } | z.objectInputType<{
939
- type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff"]>;
1034
+ type: z.ZodEnum<["checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
940
1035
  }, z.ZodTypeAny, "passthrough">>>;
941
1036
  links: z.ZodOptional<z.ZodArray<z.ZodObject<{
942
1037
  kind: z.ZodEnum<["explore", "panel", "diff", "commit", "pr", "logs", "trace", "ci_run", "deployment", "release"]>;
943
1038
  label: z.ZodString;
944
1039
  url: z.ZodEffects<z.ZodString, string, string>;
945
1040
  }, "strip", z.ZodTypeAny, {
946
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1041
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
947
1042
  label: string;
948
1043
  url: string;
949
1044
  }, {
950
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1045
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
951
1046
  label: string;
952
1047
  url: string;
953
1048
  }>, "many">>;
@@ -962,11 +1057,11 @@ export declare const ruledOutSchema: z.ZodObject<{
962
1057
  label: z.ZodString;
963
1058
  url: z.ZodEffects<z.ZodString, string, string>;
964
1059
  }, "strip", z.ZodTypeAny, {
965
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1060
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
966
1061
  label: string;
967
1062
  url: string;
968
1063
  }, {
969
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1064
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
970
1065
  label: string;
971
1066
  url: string;
972
1067
  }>, "many">>;
@@ -975,7 +1070,7 @@ export declare const ruledOutSchema: z.ZodObject<{
975
1070
  label: string;
976
1071
  id?: string | undefined;
977
1072
  links?: {
978
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1073
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
979
1074
  label: string;
980
1075
  url: string;
981
1076
  }[] | undefined;
@@ -986,7 +1081,7 @@ export declare const ruledOutSchema: z.ZodObject<{
986
1081
  label: string;
987
1082
  id?: string | undefined;
988
1083
  links?: {
989
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1084
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
990
1085
  label: string;
991
1086
  url: string;
992
1087
  }[] | undefined;
@@ -994,21 +1089,25 @@ export declare const ruledOutSchema: z.ZodObject<{
994
1089
  finding_ids?: number[] | undefined;
995
1090
  confidence_percent?: number | undefined;
996
1091
  }>;
1092
+ export declare const COVERAGE_REASONS: readonly ["wrong_account", "not_connected", "auth_expired", "error", "no_source"];
997
1093
  export declare const coverageEntrySchema: z.ZodObject<{
998
1094
  id: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
999
1095
  source: z.ZodEffects<z.ZodString, string, string>;
1000
- state: z.ZodEnum<["checked", "gap", "not_configured"]>;
1096
+ state: z.ZodEnum<["checked", "gap", "not_configured", "not_needed"]>;
1001
1097
  summary: z.ZodOptional<z.ZodString>;
1098
+ reason: z.ZodOptional<z.ZodEnum<["wrong_account", "not_connected", "auth_expired", "error", "no_source"]>>;
1099
+ retryable: z.ZodOptional<z.ZodBoolean>;
1100
+ detail: z.ZodOptional<z.ZodString>;
1002
1101
  links: z.ZodOptional<z.ZodArray<z.ZodObject<{
1003
1102
  kind: z.ZodEnum<["explore", "panel", "diff", "commit", "pr", "logs", "trace", "ci_run", "deployment", "release"]>;
1004
1103
  label: z.ZodString;
1005
1104
  url: z.ZodEffects<z.ZodString, string, string>;
1006
1105
  }, "strip", z.ZodTypeAny, {
1007
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1106
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1008
1107
  label: string;
1009
1108
  url: string;
1010
1109
  }, {
1011
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1110
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1012
1111
  label: string;
1013
1112
  url: string;
1014
1113
  }>, "many">>;
@@ -1016,29 +1115,35 @@ export declare const coverageEntrySchema: z.ZodObject<{
1016
1115
  integration_id: z.ZodOptional<z.ZodString>;
1017
1116
  finding_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
1018
1117
  }, "strip", z.ZodTypeAny, {
1019
- state: "checked" | "gap" | "not_configured";
1118
+ state: "checked" | "gap" | "not_configured" | "not_needed";
1020
1119
  source: string;
1021
1120
  id?: string | undefined;
1121
+ reason?: "error" | "wrong_account" | "not_connected" | "auth_expired" | "no_source" | undefined;
1122
+ detail?: string | undefined;
1022
1123
  summary?: string | undefined;
1023
1124
  links?: {
1024
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1125
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1025
1126
  label: string;
1026
1127
  url: string;
1027
1128
  }[] | undefined;
1028
1129
  finding_ids?: number[] | undefined;
1130
+ retryable?: boolean | undefined;
1029
1131
  step_ids?: string[] | undefined;
1030
1132
  integration_id?: string | undefined;
1031
1133
  }, {
1032
- state: "checked" | "gap" | "not_configured";
1134
+ state: "checked" | "gap" | "not_configured" | "not_needed";
1033
1135
  source: string;
1034
1136
  id?: string | undefined;
1137
+ reason?: "error" | "wrong_account" | "not_connected" | "auth_expired" | "no_source" | undefined;
1138
+ detail?: string | undefined;
1035
1139
  summary?: string | undefined;
1036
1140
  links?: {
1037
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1141
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1038
1142
  label: string;
1039
1143
  url: string;
1040
1144
  }[] | undefined;
1041
1145
  finding_ids?: number[] | undefined;
1146
+ retryable?: boolean | undefined;
1042
1147
  step_ids?: string[] | undefined;
1043
1148
  integration_id?: string | undefined;
1044
1149
  }>;
@@ -1085,11 +1190,11 @@ export declare const changeRefSchema: z.ZodEffects<z.ZodObject<{
1085
1190
  label: z.ZodString;
1086
1191
  url: z.ZodEffects<z.ZodString, string, string>;
1087
1192
  }, "strip", z.ZodTypeAny, {
1088
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1193
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1089
1194
  label: string;
1090
1195
  url: string;
1091
1196
  }, {
1092
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1197
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1093
1198
  label: string;
1094
1199
  url: string;
1095
1200
  }>, "many">>;
@@ -1100,12 +1205,12 @@ export declare const changeRefSchema: z.ZodEffects<z.ZodObject<{
1100
1205
  id?: string | undefined;
1101
1206
  author?: string | undefined;
1102
1207
  state?: "open" | "merged" | "closed" | "reverted" | "deployed" | "rolled_back" | undefined;
1103
- ref?: string | undefined;
1104
1208
  result?: "unknown" | "pending" | "skipped" | "success" | "failure" | "cancelled" | undefined;
1209
+ ref?: string | undefined;
1105
1210
  sha?: string | undefined;
1106
1211
  repo?: string | undefined;
1107
1212
  links?: {
1108
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1213
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1109
1214
  label: string;
1110
1215
  url: string;
1111
1216
  }[] | undefined;
@@ -1121,12 +1226,12 @@ export declare const changeRefSchema: z.ZodEffects<z.ZodObject<{
1121
1226
  id?: string | undefined;
1122
1227
  author?: string | undefined;
1123
1228
  state?: "open" | "merged" | "closed" | "reverted" | "deployed" | "rolled_back" | undefined;
1124
- ref?: string | undefined;
1125
1229
  result?: "unknown" | "pending" | "skipped" | "success" | "failure" | "cancelled" | undefined;
1230
+ ref?: string | undefined;
1126
1231
  sha?: string | undefined;
1127
1232
  repo?: string | undefined;
1128
1233
  links?: {
1129
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1234
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1130
1235
  label: string;
1131
1236
  url: string;
1132
1237
  }[] | undefined;
@@ -1142,12 +1247,12 @@ export declare const changeRefSchema: z.ZodEffects<z.ZodObject<{
1142
1247
  id?: string | undefined;
1143
1248
  author?: string | undefined;
1144
1249
  state?: "open" | "merged" | "closed" | "reverted" | "deployed" | "rolled_back" | undefined;
1145
- ref?: string | undefined;
1146
1250
  result?: "unknown" | "pending" | "skipped" | "success" | "failure" | "cancelled" | undefined;
1251
+ ref?: string | undefined;
1147
1252
  sha?: string | undefined;
1148
1253
  repo?: string | undefined;
1149
1254
  links?: {
1150
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1255
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1151
1256
  label: string;
1152
1257
  url: string;
1153
1258
  }[] | undefined;
@@ -1163,12 +1268,12 @@ export declare const changeRefSchema: z.ZodEffects<z.ZodObject<{
1163
1268
  id?: string | undefined;
1164
1269
  author?: string | undefined;
1165
1270
  state?: "open" | "merged" | "closed" | "reverted" | "deployed" | "rolled_back" | undefined;
1166
- ref?: string | undefined;
1167
1271
  result?: "unknown" | "pending" | "skipped" | "success" | "failure" | "cancelled" | undefined;
1272
+ ref?: string | undefined;
1168
1273
  sha?: string | undefined;
1169
1274
  repo?: string | undefined;
1170
1275
  links?: {
1171
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1276
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1172
1277
  label: string;
1173
1278
  url: string;
1174
1279
  }[] | undefined;
@@ -1200,11 +1305,11 @@ export declare const resultChangeShape: {
1200
1305
  label: z.ZodString;
1201
1306
  url: z.ZodEffects<z.ZodString, string, string>;
1202
1307
  }, "strip", z.ZodTypeAny, {
1203
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1308
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1204
1309
  label: string;
1205
1310
  url: string;
1206
1311
  }, {
1207
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1312
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1208
1313
  label: string;
1209
1314
  url: string;
1210
1315
  }>, "many">>;
@@ -1215,12 +1320,12 @@ export declare const resultChangeShape: {
1215
1320
  id?: string | undefined;
1216
1321
  author?: string | undefined;
1217
1322
  state?: "open" | "merged" | "closed" | "reverted" | "deployed" | "rolled_back" | undefined;
1218
- ref?: string | undefined;
1219
1323
  result?: "unknown" | "pending" | "skipped" | "success" | "failure" | "cancelled" | undefined;
1324
+ ref?: string | undefined;
1220
1325
  sha?: string | undefined;
1221
1326
  repo?: string | undefined;
1222
1327
  links?: {
1223
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1328
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1224
1329
  label: string;
1225
1330
  url: string;
1226
1331
  }[] | undefined;
@@ -1236,12 +1341,12 @@ export declare const resultChangeShape: {
1236
1341
  id?: string | undefined;
1237
1342
  author?: string | undefined;
1238
1343
  state?: "open" | "merged" | "closed" | "reverted" | "deployed" | "rolled_back" | undefined;
1239
- ref?: string | undefined;
1240
1344
  result?: "unknown" | "pending" | "skipped" | "success" | "failure" | "cancelled" | undefined;
1345
+ ref?: string | undefined;
1241
1346
  sha?: string | undefined;
1242
1347
  repo?: string | undefined;
1243
1348
  links?: {
1244
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1349
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1245
1350
  label: string;
1246
1351
  url: string;
1247
1352
  }[] | undefined;
@@ -1257,12 +1362,12 @@ export declare const resultChangeShape: {
1257
1362
  id?: string | undefined;
1258
1363
  author?: string | undefined;
1259
1364
  state?: "open" | "merged" | "closed" | "reverted" | "deployed" | "rolled_back" | undefined;
1260
- ref?: string | undefined;
1261
1365
  result?: "unknown" | "pending" | "skipped" | "success" | "failure" | "cancelled" | undefined;
1366
+ ref?: string | undefined;
1262
1367
  sha?: string | undefined;
1263
1368
  repo?: string | undefined;
1264
1369
  links?: {
1265
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1370
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1266
1371
  label: string;
1267
1372
  url: string;
1268
1373
  }[] | undefined;
@@ -1278,12 +1383,12 @@ export declare const resultChangeShape: {
1278
1383
  id?: string | undefined;
1279
1384
  author?: string | undefined;
1280
1385
  state?: "open" | "merged" | "closed" | "reverted" | "deployed" | "rolled_back" | undefined;
1281
- ref?: string | undefined;
1282
1386
  result?: "unknown" | "pending" | "skipped" | "success" | "failure" | "cancelled" | undefined;
1387
+ ref?: string | undefined;
1283
1388
  sha?: string | undefined;
1284
1389
  repo?: string | undefined;
1285
1390
  links?: {
1286
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1391
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1287
1392
  label: string;
1288
1393
  url: string;
1289
1394
  }[] | undefined;
@@ -1294,6 +1399,124 @@ export declare const resultChangeShape: {
1294
1399
  verification?: "unknown" | "confirmed" | "likely" | undefined;
1295
1400
  }>, "many">>;
1296
1401
  };
1402
+ export declare const ALERT_VERDICTS: readonly ["real_problem", "already_handled", "false_alarm", "not_sure"];
1403
+ export declare const ALERT_VERDICT_REASONS: readonly ["customer_impact", "internal_only", "known_incident", "declared_window", "rule_wrong", "data_wrong", "rule_needs_tuning"];
1404
+ export declare const ALERT_PROOF_IDS: readonly ["alert_value_read", "rule_read", "value_rebuilt", "flaw_removed", "baseline", "onset", "onset_change", "impact_checked", "customer_signal"];
1405
+ /**
1406
+ * The verdict on the alert behind the incident (alert_verdict_v1). The server
1407
+ * checks it and may show Not sure instead; the fields it sets itself are not
1408
+ * part of this schema.
1409
+ */
1410
+ export declare const alertVerdictSchema: z.ZodObject<{
1411
+ verdict: z.ZodEnum<["real_problem", "already_handled", "false_alarm", "not_sure"]>;
1412
+ reason: z.ZodOptional<z.ZodEnum<["customer_impact", "internal_only", "known_incident", "declared_window", "rule_wrong", "data_wrong", "rule_needs_tuning"]>>;
1413
+ onset: z.ZodOptional<z.ZodObject<{
1414
+ state: z.ZodEnum<["new", "standing", "cleared"]>;
1415
+ since: z.ZodEffects<z.ZodString, string, string>;
1416
+ }, "strip", z.ZodTypeAny, {
1417
+ state: "new" | "standing" | "cleared";
1418
+ since: string;
1419
+ }, {
1420
+ state: "new" | "standing" | "cleared";
1421
+ since: string;
1422
+ }>>;
1423
+ would_change_mind: z.ZodOptional<z.ZodObject<{
1424
+ text: z.ZodString;
1425
+ check: z.ZodOptional<z.ZodObject<{
1426
+ command_id: z.ZodString;
1427
+ op: z.ZodEnum<["above", "below"]>;
1428
+ value: z.ZodNumber;
1429
+ unit: z.ZodOptional<z.ZodString>;
1430
+ }, "strip", z.ZodTypeAny, {
1431
+ value: number;
1432
+ op: "above" | "below";
1433
+ command_id: string;
1434
+ unit?: string | undefined;
1435
+ }, {
1436
+ value: number;
1437
+ op: "above" | "below";
1438
+ command_id: string;
1439
+ unit?: string | undefined;
1440
+ }>>;
1441
+ }, "strip", z.ZodTypeAny, {
1442
+ text: string;
1443
+ check?: {
1444
+ value: number;
1445
+ op: "above" | "below";
1446
+ command_id: string;
1447
+ unit?: string | undefined;
1448
+ } | undefined;
1449
+ }, {
1450
+ text: string;
1451
+ check?: {
1452
+ value: number;
1453
+ op: "above" | "below";
1454
+ command_id: string;
1455
+ unit?: string | undefined;
1456
+ } | undefined;
1457
+ }>>;
1458
+ proof: z.ZodOptional<z.ZodArray<z.ZodObject<{
1459
+ id: z.ZodEnum<["alert_value_read", "rule_read", "value_rebuilt", "flaw_removed", "baseline", "onset", "onset_change", "impact_checked", "customer_signal"]>;
1460
+ done: z.ZodBoolean;
1461
+ finding_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
1462
+ }, "strip", z.ZodTypeAny, {
1463
+ id: "baseline" | "alert_value_read" | "rule_read" | "value_rebuilt" | "flaw_removed" | "onset" | "onset_change" | "impact_checked" | "customer_signal";
1464
+ done: boolean;
1465
+ finding_ids?: number[] | undefined;
1466
+ }, {
1467
+ id: "baseline" | "alert_value_read" | "rule_read" | "value_rebuilt" | "flaw_removed" | "onset" | "onset_change" | "impact_checked" | "customer_signal";
1468
+ done: boolean;
1469
+ finding_ids?: number[] | undefined;
1470
+ }>, "many">>;
1471
+ incident_id: z.ZodOptional<z.ZodString>;
1472
+ finding_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
1473
+ }, "strip", z.ZodTypeAny, {
1474
+ verdict: "real_problem" | "already_handled" | "false_alarm" | "not_sure";
1475
+ incident_id?: string | undefined;
1476
+ reason?: "customer_impact" | "internal_only" | "known_incident" | "declared_window" | "rule_wrong" | "data_wrong" | "rule_needs_tuning" | undefined;
1477
+ finding_ids?: number[] | undefined;
1478
+ onset?: {
1479
+ state: "new" | "standing" | "cleared";
1480
+ since: string;
1481
+ } | undefined;
1482
+ would_change_mind?: {
1483
+ text: string;
1484
+ check?: {
1485
+ value: number;
1486
+ op: "above" | "below";
1487
+ command_id: string;
1488
+ unit?: string | undefined;
1489
+ } | undefined;
1490
+ } | undefined;
1491
+ proof?: {
1492
+ id: "baseline" | "alert_value_read" | "rule_read" | "value_rebuilt" | "flaw_removed" | "onset" | "onset_change" | "impact_checked" | "customer_signal";
1493
+ done: boolean;
1494
+ finding_ids?: number[] | undefined;
1495
+ }[] | undefined;
1496
+ }, {
1497
+ verdict: "real_problem" | "already_handled" | "false_alarm" | "not_sure";
1498
+ incident_id?: string | undefined;
1499
+ reason?: "customer_impact" | "internal_only" | "known_incident" | "declared_window" | "rule_wrong" | "data_wrong" | "rule_needs_tuning" | undefined;
1500
+ finding_ids?: number[] | undefined;
1501
+ onset?: {
1502
+ state: "new" | "standing" | "cleared";
1503
+ since: string;
1504
+ } | undefined;
1505
+ would_change_mind?: {
1506
+ text: string;
1507
+ check?: {
1508
+ value: number;
1509
+ op: "above" | "below";
1510
+ command_id: string;
1511
+ unit?: string | undefined;
1512
+ } | undefined;
1513
+ } | undefined;
1514
+ proof?: {
1515
+ id: "baseline" | "alert_value_read" | "rule_read" | "value_rebuilt" | "flaw_removed" | "onset" | "onset_change" | "impact_checked" | "customer_signal";
1516
+ done: boolean;
1517
+ finding_ids?: number[] | undefined;
1518
+ }[] | undefined;
1519
+ }>;
1297
1520
  export declare const resultStructureShape: {
1298
1521
  ruled_out: z.ZodOptional<z.ZodArray<z.ZodObject<{
1299
1522
  id: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -1305,11 +1528,11 @@ export declare const resultStructureShape: {
1305
1528
  label: z.ZodString;
1306
1529
  url: z.ZodEffects<z.ZodString, string, string>;
1307
1530
  }, "strip", z.ZodTypeAny, {
1308
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1531
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1309
1532
  label: string;
1310
1533
  url: string;
1311
1534
  }, {
1312
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1535
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1313
1536
  label: string;
1314
1537
  url: string;
1315
1538
  }>, "many">>;
@@ -1318,7 +1541,7 @@ export declare const resultStructureShape: {
1318
1541
  label: string;
1319
1542
  id?: string | undefined;
1320
1543
  links?: {
1321
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1544
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1322
1545
  label: string;
1323
1546
  url: string;
1324
1547
  }[] | undefined;
@@ -1329,7 +1552,7 @@ export declare const resultStructureShape: {
1329
1552
  label: string;
1330
1553
  id?: string | undefined;
1331
1554
  links?: {
1332
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1555
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1333
1556
  label: string;
1334
1557
  url: string;
1335
1558
  }[] | undefined;
@@ -1340,18 +1563,21 @@ export declare const resultStructureShape: {
1340
1563
  coverage: z.ZodOptional<z.ZodArray<z.ZodObject<{
1341
1564
  id: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1342
1565
  source: z.ZodEffects<z.ZodString, string, string>;
1343
- state: z.ZodEnum<["checked", "gap", "not_configured"]>;
1566
+ state: z.ZodEnum<["checked", "gap", "not_configured", "not_needed"]>;
1344
1567
  summary: z.ZodOptional<z.ZodString>;
1568
+ reason: z.ZodOptional<z.ZodEnum<["wrong_account", "not_connected", "auth_expired", "error", "no_source"]>>;
1569
+ retryable: z.ZodOptional<z.ZodBoolean>;
1570
+ detail: z.ZodOptional<z.ZodString>;
1345
1571
  links: z.ZodOptional<z.ZodArray<z.ZodObject<{
1346
1572
  kind: z.ZodEnum<["explore", "panel", "diff", "commit", "pr", "logs", "trace", "ci_run", "deployment", "release"]>;
1347
1573
  label: z.ZodString;
1348
1574
  url: z.ZodEffects<z.ZodString, string, string>;
1349
1575
  }, "strip", z.ZodTypeAny, {
1350
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1576
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1351
1577
  label: string;
1352
1578
  url: string;
1353
1579
  }, {
1354
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1580
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1355
1581
  label: string;
1356
1582
  url: string;
1357
1583
  }>, "many">>;
@@ -1359,29 +1585,35 @@ export declare const resultStructureShape: {
1359
1585
  integration_id: z.ZodOptional<z.ZodString>;
1360
1586
  finding_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
1361
1587
  }, "strip", z.ZodTypeAny, {
1362
- state: "checked" | "gap" | "not_configured";
1588
+ state: "checked" | "gap" | "not_configured" | "not_needed";
1363
1589
  source: string;
1364
1590
  id?: string | undefined;
1591
+ reason?: "error" | "wrong_account" | "not_connected" | "auth_expired" | "no_source" | undefined;
1592
+ detail?: string | undefined;
1365
1593
  summary?: string | undefined;
1366
1594
  links?: {
1367
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1595
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1368
1596
  label: string;
1369
1597
  url: string;
1370
1598
  }[] | undefined;
1371
1599
  finding_ids?: number[] | undefined;
1600
+ retryable?: boolean | undefined;
1372
1601
  step_ids?: string[] | undefined;
1373
1602
  integration_id?: string | undefined;
1374
1603
  }, {
1375
- state: "checked" | "gap" | "not_configured";
1604
+ state: "checked" | "gap" | "not_configured" | "not_needed";
1376
1605
  source: string;
1377
1606
  id?: string | undefined;
1607
+ reason?: "error" | "wrong_account" | "not_connected" | "auth_expired" | "no_source" | undefined;
1608
+ detail?: string | undefined;
1378
1609
  summary?: string | undefined;
1379
1610
  links?: {
1380
- kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "deployment" | "explore" | "panel" | "logs" | "trace";
1611
+ kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
1381
1612
  label: string;
1382
1613
  url: string;
1383
1614
  }[] | undefined;
1384
1615
  finding_ids?: number[] | undefined;
1616
+ retryable?: boolean | undefined;
1385
1617
  step_ids?: string[] | undefined;
1386
1618
  integration_id?: string | undefined;
1387
1619
  }>, "many">>;
@@ -1449,6 +1681,52 @@ export declare function stripResultFigureExtras(summary: unknown): {
1449
1681
  summary: unknown;
1450
1682
  removed: string[];
1451
1683
  };
1684
+ /**
1685
+ * A result summary whose steps carry no log_lines figure: a backend without
1686
+ * log_lines_v1 rejects the figure and drops it. `removed` names each figure
1687
+ * that was taken out of its step.
1688
+ */
1689
+ export declare function stripResultLogLines(summary: unknown): {
1690
+ summary: unknown;
1691
+ removed: string[];
1692
+ };
1693
+ /**
1694
+ * A result summary whose compare figures (in steps and on actions) carry no
1695
+ * row limit. A figure that cannot stand without its limits is taken out.
1696
+ */
1697
+ export declare function stripResultFigureLimits(summary: unknown): {
1698
+ summary: unknown;
1699
+ removed: string[];
1700
+ };
1701
+ /** A result summary without the answer and the figures of recommended actions. */
1702
+ export declare function stripResultActionAnswer(summary: unknown): {
1703
+ summary: unknown;
1704
+ removed: string[];
1705
+ };
1706
+ /** A result summary without alert_verdict, for a backend that does not list alert_verdict_v1. */
1707
+ export declare function stripResultAlertVerdict(summary: unknown): {
1708
+ summary: unknown;
1709
+ removed: string[];
1710
+ };
1711
+ /**
1712
+ * A result summary without coverage entries in the state not_needed. Without
1713
+ * coverage_not_needed_v1 the entry is left out: sending `checked` would say a
1714
+ * source was read that nobody read.
1715
+ */
1716
+ export declare function stripResultNotNeeded(summary: unknown): {
1717
+ summary: unknown;
1718
+ removed: string[];
1719
+ };
1720
+ /** The coverage entries of a list without reason, retryable and detail. Names each entry changed. */
1721
+ export declare function stripCoverageReasons(coverage: unknown, path?: string): {
1722
+ coverage: unknown;
1723
+ removed: string[];
1724
+ };
1725
+ /** A result summary without the reason of a source that was not read, for a backend that does not know it. */
1726
+ export declare function stripResultCoverageReasons(summary: unknown): {
1727
+ summary: unknown;
1728
+ removed: string[];
1729
+ };
1452
1730
  /** The sentence the tool adds when it dropped fields for an older backend. */
1453
1731
  export declare function unsupportedNotice(removed: string[], capability?: string): string;
1454
1732
  export type QualityWarning = {