@tellagen/mcp-server 0.6.0 → 0.8.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 (99) hide show
  1. package/README.md +29 -4
  2. package/SKILL.md +106 -19
  3. package/contracts/mcp-protocol.json +52 -3
  4. package/contracts/runbooks/manifest.json +10 -10
  5. package/contracts/runbooks/v2/client-protocol.json +6 -0
  6. package/contracts/runbooks/v2/fixtures/filesystem-pressure.json +22 -31
  7. package/contracts/runbooks/v2/result-summary.guidance.json +53 -5
  8. package/contracts/runbooks/v2/timeline-event-blocks.schema.json +4 -2
  9. package/contracts/tellagen-runbook-contracts.json +3 -3
  10. package/dist/active-run.d.ts +6 -0
  11. package/dist/active-run.js +14 -0
  12. package/dist/active-run.js.map +1 -1
  13. package/dist/cli/doctor.d.ts +2 -2
  14. package/dist/cli/doctor.js +2 -35
  15. package/dist/cli/doctor.js.map +1 -1
  16. package/dist/cli/kubernetes.d.ts +47 -0
  17. package/dist/cli/kubernetes.js +369 -0
  18. package/dist/cli/kubernetes.js.map +1 -0
  19. package/dist/cli/main.js +5 -0
  20. package/dist/cli/main.js.map +1 -1
  21. package/dist/diagnosis-structure.d.ts +277 -24
  22. package/dist/diagnosis-structure.js +273 -8
  23. package/dist/diagnosis-structure.js.map +1 -1
  24. package/dist/doctor/checks.js +8 -2
  25. package/dist/doctor/checks.js.map +1 -1
  26. package/dist/doctor/k8s-read-only.d.ts +16 -0
  27. package/dist/doctor/k8s-read-only.js +89 -0
  28. package/dist/doctor/k8s-read-only.js.map +1 -0
  29. package/dist/doctor/real-fs.d.ts +3 -0
  30. package/dist/doctor/real-fs.js +36 -0
  31. package/dist/doctor/real-fs.js.map +1 -0
  32. package/dist/figures.d.ts +121 -26
  33. package/dist/figures.js +44 -2
  34. package/dist/figures.js.map +1 -1
  35. package/dist/heartbeat.d.ts +3 -0
  36. package/dist/heartbeat.js +32 -1
  37. package/dist/heartbeat.js.map +1 -1
  38. package/dist/index.js +1 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/k8s-safety.d.ts +2 -2
  41. package/dist/k8s-safety.js +2 -2
  42. package/dist/k8s-safety.js.map +1 -1
  43. package/dist/listen-config.d.ts +5 -5
  44. package/dist/listen-probe.d.ts +14 -1
  45. package/dist/listen-probe.js +83 -5
  46. package/dist/listen-probe.js.map +1 -1
  47. package/dist/listen-settings.d.ts +8 -0
  48. package/dist/listen-settings.js +29 -0
  49. package/dist/listen-settings.js.map +1 -1
  50. package/dist/listener.d.ts +23 -0
  51. package/dist/listener.js +122 -19
  52. package/dist/listener.js.map +1 -1
  53. package/dist/run-events.js +13 -1
  54. package/dist/run-events.js.map +1 -1
  55. package/dist/run-requests.d.ts +16 -0
  56. package/dist/run-requests.js +56 -0
  57. package/dist/run-requests.js.map +1 -0
  58. package/dist/server.d.ts +1 -1
  59. package/dist/server.js +10 -8
  60. package/dist/server.js.map +1 -1
  61. package/dist/session.d.ts +37 -0
  62. package/dist/session.js +59 -0
  63. package/dist/session.js.map +1 -1
  64. package/dist/tools/amendments.d.ts +13 -0
  65. package/dist/tools/amendments.js +206 -0
  66. package/dist/tools/amendments.js.map +1 -0
  67. package/dist/tools/catalog.js +3 -0
  68. package/dist/tools/catalog.js.map +1 -1
  69. package/dist/tools/diagnostics.js +57 -12
  70. package/dist/tools/diagnostics.js.map +1 -1
  71. package/dist/tools/figures.d.ts +1 -1
  72. package/dist/tools/figures.js +12 -6
  73. package/dist/tools/figures.js.map +1 -1
  74. package/dist/tools/findings.d.ts +128 -0
  75. package/dist/tools/findings.js +6 -6
  76. package/dist/tools/findings.js.map +1 -1
  77. package/dist/tools/index.js +4 -0
  78. package/dist/tools/index.js.map +1 -1
  79. package/dist/tools/investigations.d.ts +3223 -5
  80. package/dist/tools/investigations.js +191 -69
  81. package/dist/tools/investigations.js.map +1 -1
  82. package/dist/tools/next.d.ts +16 -0
  83. package/dist/tools/next.js +49 -1
  84. package/dist/tools/next.js.map +1 -1
  85. package/dist/tools/requests.d.ts +3 -0
  86. package/dist/tools/requests.js +62 -0
  87. package/dist/tools/requests.js.map +1 -0
  88. package/dist/tools/resume.js +14 -1
  89. package/dist/tools/resume.js.map +1 -1
  90. package/dist/tools/timeline.js +13 -2
  91. package/dist/tools/timeline.js.map +1 -1
  92. package/dist/unattended.d.ts +10 -0
  93. package/dist/unattended.js +13 -0
  94. package/dist/unattended.js.map +1 -0
  95. package/dist/version.d.ts +4 -2
  96. package/dist/version.js +4 -1
  97. package/dist/version.js.map +1 -1
  98. package/package.json +1 -1
  99. package/server.json +1 -1
@@ -17,7 +17,7 @@
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
21
  import { type RunWindow } from "./run-window.js";
22
22
  import { RECORDED_STEPS_CAPABILITY } from "./trace-record.js";
23
23
  export { RECORDED_STEPS_CAPABILITY };
@@ -30,7 +30,18 @@ export declare const RUN_IMAGES_CAPABILITY = "run_images_v1";
30
30
  export declare const DIFF_LINES_CAPABILITY = "diff_lines_v1";
31
31
  /** The server takes a log_lines figure. */
32
32
  export declare const LOG_LINES_CAPABILITY = "log_lines_v1";
33
- export { FIGURE_EXTRAS_CAPABILITY };
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";
34
45
  /**
35
46
  * Remembers the capabilities the backend that answered a pickup or context
36
47
  * call for `runId` advertises. A missing `server_capabilities` is a definite
@@ -56,6 +67,16 @@ export declare function supportsDiffLines(client: TellagenClient, runId?: string
56
67
  * runs_not_shown. Decided like supportsDiffLines.
57
68
  */
58
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>;
59
80
  /**
60
81
  * Whether the backend takes a log_lines figure. Decided like supportsDiffLines:
61
82
  * with a run id it asks for that run, otherwise the latest pickup of this
@@ -196,11 +217,12 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
196
217
  value: number;
197
218
  label?: string | undefined;
198
219
  }>>;
199
- rows: z.ZodArray<z.ZodObject<{
220
+ rows: z.ZodArray<z.ZodEffects<z.ZodObject<{
200
221
  label: z.ZodEffects<z.ZodString, string, string>;
201
222
  mono: z.ZodOptional<z.ZodBoolean>;
202
- before: z.ZodNumber;
223
+ before: z.ZodOptional<z.ZodNumber>;
203
224
  after: z.ZodNumber;
225
+ limit: z.ZodOptional<z.ZodNumber>;
204
226
  details: z.ZodOptional<z.ZodArray<z.ZodObject<{
205
227
  label: z.ZodEffects<z.ZodString, string, string>;
206
228
  before: z.ZodEffects<z.ZodString, string, string>;
@@ -216,7 +238,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
216
238
  }>, "many">>;
217
239
  }, "strict", z.ZodTypeAny, {
218
240
  label: string;
219
- before: number;
220
241
  after: number;
221
242
  details?: {
222
243
  label: string;
@@ -224,9 +245,10 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
224
245
  after: string;
225
246
  }[] | undefined;
226
247
  mono?: boolean | undefined;
248
+ before?: number | undefined;
249
+ limit?: number | undefined;
227
250
  }, {
228
251
  label: string;
229
- before: number;
230
252
  after: number;
231
253
  details?: {
232
254
  label: string;
@@ -234,6 +256,30 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
234
256
  after: string;
235
257
  }[] | undefined;
236
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;
272
+ }, {
273
+ label: string;
274
+ after: number;
275
+ details?: {
276
+ label: string;
277
+ before: string;
278
+ after: string;
279
+ }[] | undefined;
280
+ mono?: boolean | undefined;
281
+ before?: number | undefined;
282
+ limit?: number | undefined;
237
283
  }>, "many">;
238
284
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
239
285
  anchor: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -243,7 +289,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
243
289
  type: "compare";
244
290
  rows: {
245
291
  label: string;
246
- before: number;
247
292
  after: number;
248
293
  details?: {
249
294
  label: string;
@@ -251,6 +296,8 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
251
296
  after: string;
252
297
  }[] | undefined;
253
298
  mono?: boolean | undefined;
299
+ before?: number | undefined;
300
+ limit?: number | undefined;
254
301
  }[];
255
302
  title?: string | undefined;
256
303
  anchor?: string | undefined;
@@ -269,7 +316,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
269
316
  type: "compare";
270
317
  rows: {
271
318
  label: string;
272
- before: number;
273
319
  after: number;
274
320
  details?: {
275
321
  label: string;
@@ -277,6 +323,8 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
277
323
  after: string;
278
324
  }[] | undefined;
279
325
  mono?: boolean | undefined;
326
+ before?: number | undefined;
327
+ limit?: number | undefined;
280
328
  }[];
281
329
  title?: string | undefined;
282
330
  anchor?: string | undefined;
@@ -424,7 +472,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
424
472
  type: "compare";
425
473
  rows: {
426
474
  label: string;
427
- before: number;
428
475
  after: number;
429
476
  details?: {
430
477
  label: string;
@@ -432,6 +479,8 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
432
479
  after: string;
433
480
  }[] | undefined;
434
481
  mono?: boolean | undefined;
482
+ before?: number | undefined;
483
+ limit?: number | undefined;
435
484
  }[];
436
485
  title?: string | undefined;
437
486
  anchor?: string | undefined;
@@ -491,7 +540,6 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
491
540
  type: "compare";
492
541
  rows: {
493
542
  label: string;
494
- before: number;
495
543
  after: number;
496
544
  details?: {
497
545
  label: string;
@@ -499,6 +547,8 @@ export declare const stepFigureSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"typ
499
547
  after: string;
500
548
  }[] | undefined;
501
549
  mono?: boolean | undefined;
550
+ before?: number | undefined;
551
+ limit?: number | undefined;
502
552
  }[];
503
553
  title?: string | undefined;
504
554
  anchor?: string | undefined;
@@ -606,11 +656,12 @@ export declare const stepStructureShape: {
606
656
  value: number;
607
657
  label?: string | undefined;
608
658
  }>>;
609
- rows: z.ZodArray<z.ZodObject<{
659
+ rows: z.ZodArray<z.ZodEffects<z.ZodObject<{
610
660
  label: z.ZodEffects<z.ZodString, string, string>;
611
661
  mono: z.ZodOptional<z.ZodBoolean>;
612
- before: z.ZodNumber;
662
+ before: z.ZodOptional<z.ZodNumber>;
613
663
  after: z.ZodNumber;
664
+ limit: z.ZodOptional<z.ZodNumber>;
614
665
  details: z.ZodOptional<z.ZodArray<z.ZodObject<{
615
666
  label: z.ZodEffects<z.ZodString, string, string>;
616
667
  before: z.ZodEffects<z.ZodString, string, string>;
@@ -626,7 +677,6 @@ export declare const stepStructureShape: {
626
677
  }>, "many">>;
627
678
  }, "strict", z.ZodTypeAny, {
628
679
  label: string;
629
- before: number;
630
680
  after: number;
631
681
  details?: {
632
682
  label: string;
@@ -634,9 +684,32 @@ export declare const stepStructureShape: {
634
684
  after: string;
635
685
  }[] | undefined;
636
686
  mono?: boolean | undefined;
687
+ before?: number | undefined;
688
+ limit?: number | undefined;
689
+ }, {
690
+ label: string;
691
+ after: number;
692
+ details?: {
693
+ label: string;
694
+ before: string;
695
+ after: string;
696
+ }[] | undefined;
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;
637
711
  }, {
638
712
  label: string;
639
- before: number;
640
713
  after: number;
641
714
  details?: {
642
715
  label: string;
@@ -644,6 +717,8 @@ export declare const stepStructureShape: {
644
717
  after: string;
645
718
  }[] | undefined;
646
719
  mono?: boolean | undefined;
720
+ before?: number | undefined;
721
+ limit?: number | undefined;
647
722
  }>, "many">;
648
723
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
649
724
  anchor: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -653,7 +728,6 @@ export declare const stepStructureShape: {
653
728
  type: "compare";
654
729
  rows: {
655
730
  label: string;
656
- before: number;
657
731
  after: number;
658
732
  details?: {
659
733
  label: string;
@@ -661,6 +735,8 @@ export declare const stepStructureShape: {
661
735
  after: string;
662
736
  }[] | undefined;
663
737
  mono?: boolean | undefined;
738
+ before?: number | undefined;
739
+ limit?: number | undefined;
664
740
  }[];
665
741
  title?: string | undefined;
666
742
  anchor?: string | undefined;
@@ -679,7 +755,6 @@ export declare const stepStructureShape: {
679
755
  type: "compare";
680
756
  rows: {
681
757
  label: string;
682
- before: number;
683
758
  after: number;
684
759
  details?: {
685
760
  label: string;
@@ -687,6 +762,8 @@ export declare const stepStructureShape: {
687
762
  after: string;
688
763
  }[] | undefined;
689
764
  mono?: boolean | undefined;
765
+ before?: number | undefined;
766
+ limit?: number | undefined;
690
767
  }[];
691
768
  title?: string | undefined;
692
769
  anchor?: string | undefined;
@@ -834,7 +911,6 @@ export declare const stepStructureShape: {
834
911
  type: "compare";
835
912
  rows: {
836
913
  label: string;
837
- before: number;
838
914
  after: number;
839
915
  details?: {
840
916
  label: string;
@@ -842,6 +918,8 @@ export declare const stepStructureShape: {
842
918
  after: string;
843
919
  }[] | undefined;
844
920
  mono?: boolean | undefined;
921
+ before?: number | undefined;
922
+ limit?: number | undefined;
845
923
  }[];
846
924
  title?: string | undefined;
847
925
  anchor?: string | undefined;
@@ -901,7 +979,6 @@ export declare const stepStructureShape: {
901
979
  type: "compare";
902
980
  rows: {
903
981
  label: string;
904
- before: number;
905
982
  after: number;
906
983
  details?: {
907
984
  label: string;
@@ -909,6 +986,8 @@ export declare const stepStructureShape: {
909
986
  after: string;
910
987
  }[] | undefined;
911
988
  mono?: boolean | undefined;
989
+ before?: number | undefined;
990
+ limit?: number | undefined;
912
991
  }[];
913
992
  title?: string | undefined;
914
993
  anchor?: string | undefined;
@@ -1010,11 +1089,15 @@ export declare const ruledOutSchema: z.ZodObject<{
1010
1089
  finding_ids?: number[] | undefined;
1011
1090
  confidence_percent?: number | undefined;
1012
1091
  }>;
1092
+ export declare const COVERAGE_REASONS: readonly ["wrong_account", "not_connected", "auth_expired", "error", "no_source"];
1013
1093
  export declare const coverageEntrySchema: z.ZodObject<{
1014
1094
  id: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1015
1095
  source: z.ZodEffects<z.ZodString, string, string>;
1016
- state: z.ZodEnum<["checked", "gap", "not_configured"]>;
1096
+ state: z.ZodEnum<["checked", "gap", "not_configured", "not_needed"]>;
1017
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>;
1018
1101
  links: z.ZodOptional<z.ZodArray<z.ZodObject<{
1019
1102
  kind: z.ZodEnum<["explore", "panel", "diff", "commit", "pr", "logs", "trace", "ci_run", "deployment", "release"]>;
1020
1103
  label: z.ZodString;
@@ -1032,9 +1115,11 @@ export declare const coverageEntrySchema: z.ZodObject<{
1032
1115
  integration_id: z.ZodOptional<z.ZodString>;
1033
1116
  finding_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
1034
1117
  }, "strip", z.ZodTypeAny, {
1035
- state: "checked" | "gap" | "not_configured";
1118
+ state: "checked" | "gap" | "not_configured" | "not_needed";
1036
1119
  source: string;
1037
1120
  id?: string | undefined;
1121
+ reason?: "error" | "wrong_account" | "not_connected" | "auth_expired" | "no_source" | undefined;
1122
+ detail?: string | undefined;
1038
1123
  summary?: string | undefined;
1039
1124
  links?: {
1040
1125
  kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
@@ -1042,12 +1127,15 @@ export declare const coverageEntrySchema: z.ZodObject<{
1042
1127
  url: string;
1043
1128
  }[] | undefined;
1044
1129
  finding_ids?: number[] | undefined;
1130
+ retryable?: boolean | undefined;
1045
1131
  step_ids?: string[] | undefined;
1046
1132
  integration_id?: string | undefined;
1047
1133
  }, {
1048
- state: "checked" | "gap" | "not_configured";
1134
+ state: "checked" | "gap" | "not_configured" | "not_needed";
1049
1135
  source: string;
1050
1136
  id?: string | undefined;
1137
+ reason?: "error" | "wrong_account" | "not_connected" | "auth_expired" | "no_source" | undefined;
1138
+ detail?: string | undefined;
1051
1139
  summary?: string | undefined;
1052
1140
  links?: {
1053
1141
  kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
@@ -1055,6 +1143,7 @@ export declare const coverageEntrySchema: z.ZodObject<{
1055
1143
  url: string;
1056
1144
  }[] | undefined;
1057
1145
  finding_ids?: number[] | undefined;
1146
+ retryable?: boolean | undefined;
1058
1147
  step_ids?: string[] | undefined;
1059
1148
  integration_id?: string | undefined;
1060
1149
  }>;
@@ -1310,6 +1399,124 @@ export declare const resultChangeShape: {
1310
1399
  verification?: "unknown" | "confirmed" | "likely" | undefined;
1311
1400
  }>, "many">>;
1312
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
+ }>;
1313
1520
  export declare const resultStructureShape: {
1314
1521
  ruled_out: z.ZodOptional<z.ZodArray<z.ZodObject<{
1315
1522
  id: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -1356,8 +1563,11 @@ export declare const resultStructureShape: {
1356
1563
  coverage: z.ZodOptional<z.ZodArray<z.ZodObject<{
1357
1564
  id: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1358
1565
  source: z.ZodEffects<z.ZodString, string, string>;
1359
- state: z.ZodEnum<["checked", "gap", "not_configured"]>;
1566
+ state: z.ZodEnum<["checked", "gap", "not_configured", "not_needed"]>;
1360
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>;
1361
1571
  links: z.ZodOptional<z.ZodArray<z.ZodObject<{
1362
1572
  kind: z.ZodEnum<["explore", "panel", "diff", "commit", "pr", "logs", "trace", "ci_run", "deployment", "release"]>;
1363
1573
  label: z.ZodString;
@@ -1375,9 +1585,11 @@ export declare const resultStructureShape: {
1375
1585
  integration_id: z.ZodOptional<z.ZodString>;
1376
1586
  finding_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
1377
1587
  }, "strip", z.ZodTypeAny, {
1378
- state: "checked" | "gap" | "not_configured";
1588
+ state: "checked" | "gap" | "not_configured" | "not_needed";
1379
1589
  source: string;
1380
1590
  id?: string | undefined;
1591
+ reason?: "error" | "wrong_account" | "not_connected" | "auth_expired" | "no_source" | undefined;
1592
+ detail?: string | undefined;
1381
1593
  summary?: string | undefined;
1382
1594
  links?: {
1383
1595
  kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
@@ -1385,12 +1597,15 @@ export declare const resultStructureShape: {
1385
1597
  url: string;
1386
1598
  }[] | undefined;
1387
1599
  finding_ids?: number[] | undefined;
1600
+ retryable?: boolean | undefined;
1388
1601
  step_ids?: string[] | undefined;
1389
1602
  integration_id?: string | undefined;
1390
1603
  }, {
1391
- state: "checked" | "gap" | "not_configured";
1604
+ state: "checked" | "gap" | "not_configured" | "not_needed";
1392
1605
  source: string;
1393
1606
  id?: string | undefined;
1607
+ reason?: "error" | "wrong_account" | "not_connected" | "auth_expired" | "no_source" | undefined;
1608
+ detail?: string | undefined;
1394
1609
  summary?: string | undefined;
1395
1610
  links?: {
1396
1611
  kind: "diff" | "commit" | "pr" | "ci_run" | "release" | "trace" | "deployment" | "explore" | "panel" | "logs";
@@ -1398,6 +1613,7 @@ export declare const resultStructureShape: {
1398
1613
  url: string;
1399
1614
  }[] | undefined;
1400
1615
  finding_ids?: number[] | undefined;
1616
+ retryable?: boolean | undefined;
1401
1617
  step_ids?: string[] | undefined;
1402
1618
  integration_id?: string | undefined;
1403
1619
  }>, "many">>;
@@ -1474,6 +1690,43 @@ export declare function stripResultLogLines(summary: unknown): {
1474
1690
  summary: unknown;
1475
1691
  removed: string[];
1476
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
+ };
1477
1730
  /** The sentence the tool adds when it dropped fields for an older backend. */
1478
1731
  export declare function unsupportedNotice(removed: string[], capability?: string): string;
1479
1732
  export type QualityWarning = {