@tellagen/mcp-server 0.5.1 → 0.6.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 (74) hide show
  1. package/README.md +29 -3
  2. package/SKILL.md +40 -3
  3. package/contracts/mcp-protocol.json +13 -1
  4. package/contracts/runbooks/manifest.json +20 -10
  5. package/contracts/runbooks/v2/client-protocol.json +59 -2
  6. package/contracts/runbooks/v2/client-writes.guidance.json +16 -1
  7. package/contracts/runbooks/v2/fixtures/timeline-event-blocks-rejected.json +15 -1
  8. package/contracts/runbooks/v2/investigation-window.guidance.json +45 -0
  9. package/contracts/runbooks/v2/question-checks.guidance.json +49 -0
  10. package/contracts/runbooks/v2/timeline-event-blocks.schema.json +62 -1
  11. package/contracts/tellagen-runbook-contracts.json +3 -3
  12. package/dist/cli/doctor.d.ts +19 -0
  13. package/dist/cli/doctor.js +212 -0
  14. package/dist/cli/doctor.js.map +1 -0
  15. package/dist/cli/main.js +5 -0
  16. package/dist/cli/main.js.map +1 -1
  17. package/dist/diagnosis-structure.d.ts +103 -78
  18. package/dist/diagnosis-structure.js +62 -7
  19. package/dist/diagnosis-structure.js.map +1 -1
  20. package/dist/doctor/checks.d.ts +42 -0
  21. package/dist/doctor/checks.js +175 -0
  22. package/dist/doctor/checks.js.map +1 -0
  23. package/dist/doctor/config-files.d.ts +49 -0
  24. package/dist/doctor/config-files.js +121 -0
  25. package/dist/doctor/config-files.js.map +1 -0
  26. package/dist/doctor/toml.d.ts +13 -0
  27. package/dist/doctor/toml.js +205 -0
  28. package/dist/doctor/toml.js.map +1 -0
  29. package/dist/figures.d.ts +407 -83
  30. package/dist/figures.js +297 -5
  31. package/dist/figures.js.map +1 -1
  32. package/dist/index.js +1 -1
  33. package/dist/index.js.map +1 -1
  34. package/dist/k8s-safety.d.ts +42 -0
  35. package/dist/k8s-safety.js +33 -0
  36. package/dist/k8s-safety.js.map +1 -0
  37. package/dist/log-lines.d.ts +118 -0
  38. package/dist/log-lines.js +534 -0
  39. package/dist/log-lines.js.map +1 -0
  40. package/dist/redact.d.ts +21 -0
  41. package/dist/redact.js +212 -5
  42. package/dist/redact.js.map +1 -1
  43. package/dist/run-window.d.ts +59 -0
  44. package/dist/run-window.js +141 -0
  45. package/dist/run-window.js.map +1 -0
  46. package/dist/server.d.ts +1 -1
  47. package/dist/server.js +1 -1
  48. package/dist/tool-report.d.ts +2 -0
  49. package/dist/tool-report.js +3 -0
  50. package/dist/tool-report.js.map +1 -0
  51. package/dist/tools/catalog.js +1 -0
  52. package/dist/tools/catalog.js.map +1 -1
  53. package/dist/tools/diagnostics.js +85 -2
  54. package/dist/tools/diagnostics.js.map +1 -1
  55. package/dist/tools/figures.d.ts +2 -2
  56. package/dist/tools/figures.js +29 -7
  57. package/dist/tools/figures.js.map +1 -1
  58. package/dist/tools/findings.d.ts +8 -0
  59. package/dist/tools/findings.js +63 -2
  60. package/dist/tools/findings.js.map +1 -1
  61. package/dist/tools/investigations.d.ts +1 -1
  62. package/dist/tools/investigations.js +43 -4
  63. package/dist/tools/investigations.js.map +1 -1
  64. package/dist/tools/postmortem-runbooks.d.ts +20 -20
  65. package/dist/tools/source-links.d.ts +7 -0
  66. package/dist/tools/source-links.js +32 -5
  67. package/dist/tools/source-links.js.map +1 -1
  68. package/dist/tools/timeline.js +13 -2
  69. package/dist/tools/timeline.js.map +1 -1
  70. package/dist/version.d.ts +2 -2
  71. package/dist/version.js +3 -1
  72. package/dist/version.js.map +1 -1
  73. package/package.json +1 -1
  74. package/server.json +1 -1
package/dist/figures.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { z } from "zod";
2
+ import { type RunWindow } from "./run-window.js";
2
3
  /**
3
4
  * Figures are the typed widgets Tellagen draws in the Diagnosis tab, on the
4
5
  * timeline and in the postmortem. The agent sends data and Tellagen draws it.
@@ -13,17 +14,27 @@ import { z } from "zod";
13
14
  * Types a causal step may carry as its `figure`. table and changes are
14
15
  * timeline blocks only.
15
16
  */
16
- export declare const STEP_FIGURE_TYPES: readonly ["stats", "compare", "trend", "checks", "range_overlap", "histogram", "run_history", "diff"];
17
+ export declare const STEP_FIGURE_TYPES: readonly ["stats", "compare", "trend", "checks", "range_overlap", "histogram", "run_history", "diff", "log_lines"];
17
18
  /** Types the API accepts in a timeline event's `blocks`. */
18
- export declare const TIMELINE_BLOCK_TYPES: readonly ["stats", "compare", "trend", "table", "checks", "changes", "range_overlap", "histogram", "run_history", "diff"];
19
+ export declare const TIMELINE_BLOCK_TYPES: readonly ["stats", "compare", "trend", "table", "checks", "changes", "range_overlap", "histogram", "run_history", "diff", "log_lines"];
19
20
  /** The most JSON one step figure may take, as the backend measures it. */
20
21
  export declare const MAX_STEP_FIGURE_BYTES: number;
22
+ /**
23
+ * A log_lines figure may take more: 8 lines of 500 characters with fields are
24
+ * about 20 KB. A Tellagen that lists log_lines_v1 accepts a step figure of
25
+ * this size.
26
+ */
27
+ export declare const MAX_LOG_LINES_STEP_FIGURE_BYTES: number;
28
+ /** The most JSON a step figure of this type may take. */
29
+ export declare function maxStepFigureBytes(type: unknown): number;
21
30
  export type FigurePlacement = "step_figure" | "timeline_block";
22
31
  /** Stats a server with figure_extras_v1 takes; the first MAX_STATS_TILES are tiles. */
23
32
  export declare const MAX_STATS_ITEMS = 8;
24
33
  export declare const MAX_STATS_TILES = 4;
25
34
  /** The server takes a stats title, more than 4 stats and runs_not_shown. */
26
35
  export declare const FIGURE_EXTRAS_CAPABILITY = "figure_extras_v1";
36
+ /** The server takes a log_lines figure. */
37
+ export declare const LOG_LINES_CAPABILITY = "log_lines_v1";
27
38
  export declare const RUN_RESULTS: readonly ["success", "failure", "cancelled", "pending"];
28
39
  export declare const RUN_MARK_CHANGES: readonly ["regression", "fix", "change"];
29
40
  /** Exported for the step figure schema of tellagen_complete_investigation. */
@@ -88,10 +99,10 @@ export declare const rangeOverlapBlockSchema: z.ZodObject<{
88
99
  to: number;
89
100
  }[];
90
101
  title?: string | undefined;
102
+ window?: [number, number] | undefined;
91
103
  unit?: string | undefined;
92
104
  max?: number | undefined;
93
105
  min?: number | undefined;
94
- window?: [number, number] | undefined;
95
106
  }, {
96
107
  type: "range_overlap";
97
108
  rows: {
@@ -100,10 +111,10 @@ export declare const rangeOverlapBlockSchema: z.ZodObject<{
100
111
  to: number;
101
112
  }[];
102
113
  title?: string | undefined;
114
+ window?: [number, number] | undefined;
103
115
  unit?: string | undefined;
104
116
  max?: number | undefined;
105
117
  min?: number | undefined;
106
- window?: [number, number] | undefined;
107
118
  }>;
108
119
  export declare const histogramBlockSchema: z.ZodObject<{
109
120
  type: z.ZodLiteral<"histogram">;
@@ -133,17 +144,17 @@ export declare const histogramBlockSchema: z.ZodObject<{
133
144
  }, "strict", z.ZodTypeAny, {
134
145
  datasource?: string | undefined;
135
146
  kind?: string | undefined;
136
- query?: string | undefined;
137
147
  from?: string | undefined;
138
148
  to?: string | undefined;
149
+ query?: string | undefined;
139
150
  step?: string | undefined;
140
151
  artifact_id?: string | undefined;
141
152
  }, {
142
153
  datasource?: string | undefined;
143
154
  kind?: string | undefined;
144
- query?: string | undefined;
145
155
  from?: string | undefined;
146
156
  to?: string | undefined;
157
+ query?: string | undefined;
147
158
  step?: string | undefined;
148
159
  artifact_id?: string | undefined;
149
160
  }>>;
@@ -156,9 +167,9 @@ export declare const histogramBlockSchema: z.ZodObject<{
156
167
  source?: {
157
168
  datasource?: string | undefined;
158
169
  kind?: string | undefined;
159
- query?: string | undefined;
160
170
  from?: string | undefined;
161
171
  to?: string | undefined;
172
+ query?: string | undefined;
162
173
  step?: string | undefined;
163
174
  artifact_id?: string | undefined;
164
175
  } | undefined;
@@ -176,9 +187,9 @@ export declare const histogramBlockSchema: z.ZodObject<{
176
187
  source?: {
177
188
  datasource?: string | undefined;
178
189
  kind?: string | undefined;
179
- query?: string | undefined;
180
190
  from?: string | undefined;
181
191
  to?: string | undefined;
192
+ query?: string | undefined;
182
193
  step?: string | undefined;
183
194
  artifact_id?: string | undefined;
184
195
  } | undefined;
@@ -202,16 +213,16 @@ export declare const runHistoryBlockSchema: z.ZodObject<{
202
213
  job: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
203
214
  url: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
204
215
  }, "strict", z.ZodTypeAny, {
205
- ref: string;
206
216
  result: "pending" | "success" | "failure" | "cancelled";
217
+ ref: string;
207
218
  at?: string | undefined;
208
219
  url?: string | undefined;
209
220
  sha?: string | undefined;
210
221
  trigger?: string | undefined;
211
222
  job?: string | undefined;
212
223
  }, {
213
- ref: string;
214
224
  result: "pending" | "success" | "failure" | "cancelled";
225
+ ref: string;
215
226
  at?: string | undefined;
216
227
  url?: string | undefined;
217
228
  sha?: string | undefined;
@@ -254,8 +265,8 @@ export declare const runHistoryBlockSchema: z.ZodObject<{
254
265
  }, "strict", z.ZodTypeAny, {
255
266
  type: "run_history";
256
267
  runs: {
257
- ref: string;
258
268
  result: "pending" | "success" | "failure" | "cancelled";
269
+ ref: string;
259
270
  at?: string | undefined;
260
271
  url?: string | undefined;
261
272
  sha?: string | undefined;
@@ -281,8 +292,8 @@ export declare const runHistoryBlockSchema: z.ZodObject<{
281
292
  }, {
282
293
  type: "run_history";
283
294
  runs: {
284
- ref: string;
285
295
  result: "pending" | "success" | "failure" | "cancelled";
296
+ ref: string;
286
297
  at?: string | undefined;
287
298
  url?: string | undefined;
288
299
  sha?: string | undefined;
@@ -362,6 +373,99 @@ export declare const diffBlockSchema: z.ZodObject<{
362
373
  title?: string | undefined;
363
374
  repo?: string | undefined;
364
375
  }>;
376
+ export declare const logLinesBlockSchema: z.ZodObject<{
377
+ type: z.ZodLiteral<"log_lines">;
378
+ title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
379
+ source: z.ZodOptional<z.ZodObject<{
380
+ kind: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
381
+ datasource: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
382
+ query: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
383
+ from: z.ZodOptional<z.ZodString>;
384
+ to: z.ZodOptional<z.ZodString>;
385
+ }, "strict", z.ZodTypeAny, {
386
+ datasource?: string | undefined;
387
+ kind?: string | undefined;
388
+ from?: string | undefined;
389
+ to?: string | undefined;
390
+ query?: string | undefined;
391
+ }, {
392
+ datasource?: string | undefined;
393
+ kind?: string | undefined;
394
+ from?: string | undefined;
395
+ to?: string | undefined;
396
+ query?: string | undefined;
397
+ }>>;
398
+ matched: z.ZodNumber;
399
+ scanned: z.ZodOptional<z.ZodNumber>;
400
+ event_at: z.ZodOptional<z.ZodString>;
401
+ lines: z.ZodOptional<z.ZodArray<z.ZodObject<{
402
+ time: z.ZodString;
403
+ level: z.ZodEnum<["error", "warn", "info", "debug", "other"]>;
404
+ text: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
405
+ fields: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>, Record<string, string>, Record<string, string>>>;
406
+ relation: z.ZodOptional<z.ZodEnum<["matches_event", "context", "unrelated"]>>;
407
+ note: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
408
+ }, "strict", z.ZodTypeAny, {
409
+ text: string;
410
+ level: "other" | "error" | "warn" | "info" | "debug";
411
+ time: string;
412
+ fields?: Record<string, string> | undefined;
413
+ relation?: "context" | "matches_event" | "unrelated" | undefined;
414
+ note?: string | undefined;
415
+ }, {
416
+ text: string;
417
+ level: "other" | "error" | "warn" | "info" | "debug";
418
+ time: string;
419
+ fields?: Record<string, string> | undefined;
420
+ relation?: "context" | "matches_event" | "unrelated" | undefined;
421
+ note?: string | undefined;
422
+ }>, "many">>;
423
+ lines_not_shown: z.ZodOptional<z.ZodNumber>;
424
+ }, "strict", z.ZodTypeAny, {
425
+ type: "log_lines";
426
+ matched: number;
427
+ title?: string | undefined;
428
+ source?: {
429
+ datasource?: string | undefined;
430
+ kind?: string | undefined;
431
+ from?: string | undefined;
432
+ to?: string | undefined;
433
+ query?: string | undefined;
434
+ } | undefined;
435
+ lines?: {
436
+ text: string;
437
+ level: "other" | "error" | "warn" | "info" | "debug";
438
+ time: string;
439
+ fields?: Record<string, string> | undefined;
440
+ relation?: "context" | "matches_event" | "unrelated" | undefined;
441
+ note?: string | undefined;
442
+ }[] | undefined;
443
+ scanned?: number | undefined;
444
+ event_at?: string | undefined;
445
+ lines_not_shown?: number | undefined;
446
+ }, {
447
+ type: "log_lines";
448
+ matched: number;
449
+ title?: string | undefined;
450
+ source?: {
451
+ datasource?: string | undefined;
452
+ kind?: string | undefined;
453
+ from?: string | undefined;
454
+ to?: string | undefined;
455
+ query?: string | undefined;
456
+ } | undefined;
457
+ lines?: {
458
+ text: string;
459
+ level: "other" | "error" | "warn" | "info" | "debug";
460
+ time: string;
461
+ fields?: Record<string, string> | undefined;
462
+ relation?: "context" | "matches_event" | "unrelated" | undefined;
463
+ note?: string | undefined;
464
+ }[] | undefined;
465
+ scanned?: number | undefined;
466
+ event_at?: string | undefined;
467
+ lines_not_shown?: number | undefined;
468
+ }>;
365
469
  export type FigureRuleIssue = {
366
470
  path: Array<string | number>;
367
471
  message: string;
@@ -390,12 +494,12 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
390
494
  value: string;
391
495
  label: string;
392
496
  caption?: string | undefined;
393
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
497
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
394
498
  }, {
395
499
  value: string;
396
500
  label: string;
397
501
  caption?: string | undefined;
398
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
502
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
399
503
  }>, "many">;
400
504
  } & {
401
505
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
@@ -407,7 +511,7 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
407
511
  value: string;
408
512
  label: string;
409
513
  caption?: string | undefined;
410
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
514
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
411
515
  }[];
412
516
  title?: string | undefined;
413
517
  anchor?: string | undefined;
@@ -419,7 +523,7 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
419
523
  value: string;
420
524
  label: string;
421
525
  caption?: string | undefined;
422
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
526
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
423
527
  }[];
424
528
  title?: string | undefined;
425
529
  anchor?: string | undefined;
@@ -577,17 +681,17 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
577
681
  }, "strict", z.ZodTypeAny, {
578
682
  datasource?: string | undefined;
579
683
  kind?: string | undefined;
580
- query?: string | undefined;
581
684
  from?: string | undefined;
582
685
  to?: string | undefined;
686
+ query?: string | undefined;
583
687
  step?: string | undefined;
584
688
  artifact_id?: string | undefined;
585
689
  }, {
586
690
  datasource?: string | undefined;
587
691
  kind?: string | undefined;
588
- query?: string | undefined;
589
692
  from?: string | undefined;
590
693
  to?: string | undefined;
694
+ query?: string | undefined;
591
695
  step?: string | undefined;
592
696
  artifact_id?: string | undefined;
593
697
  }>>;
@@ -603,9 +707,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
603
707
  source?: {
604
708
  datasource?: string | undefined;
605
709
  kind?: string | undefined;
606
- query?: string | undefined;
607
710
  from?: string | undefined;
608
711
  to?: string | undefined;
712
+ query?: string | undefined;
609
713
  step?: string | undefined;
610
714
  artifact_id?: string | undefined;
611
715
  } | undefined;
@@ -631,9 +735,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
631
735
  source?: {
632
736
  datasource?: string | undefined;
633
737
  kind?: string | undefined;
634
- query?: string | undefined;
635
738
  from?: string | undefined;
636
739
  to?: string | undefined;
740
+ query?: string | undefined;
637
741
  step?: string | undefined;
638
742
  artifact_id?: string | undefined;
639
743
  } | undefined;
@@ -748,14 +852,14 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
748
852
  note: z.ZodOptional<z.ZodString>;
749
853
  }, "strict", z.ZodTypeAny, {
750
854
  label: string;
855
+ note?: string | undefined;
751
856
  from?: string | undefined;
752
857
  to?: string | undefined;
753
- note?: string | undefined;
754
858
  }, {
755
859
  label: string;
860
+ note?: string | undefined;
756
861
  from?: string | undefined;
757
862
  to?: string | undefined;
758
- note?: string | undefined;
759
863
  }>, "many">;
760
864
  } & {
761
865
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
@@ -765,9 +869,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
765
869
  type: "changes";
766
870
  rows: {
767
871
  label: string;
872
+ note?: string | undefined;
768
873
  from?: string | undefined;
769
874
  to?: string | undefined;
770
- note?: string | undefined;
771
875
  }[];
772
876
  title?: string | undefined;
773
877
  anchor?: string | undefined;
@@ -777,9 +881,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
777
881
  type: "changes";
778
882
  rows: {
779
883
  label: string;
884
+ note?: string | undefined;
780
885
  from?: string | undefined;
781
886
  to?: string | undefined;
782
- note?: string | undefined;
783
887
  }[];
784
888
  title?: string | undefined;
785
889
  anchor?: string | undefined;
@@ -819,10 +923,10 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
819
923
  title?: string | undefined;
820
924
  anchor?: string | undefined;
821
925
  postmortem?: boolean | undefined;
926
+ window?: [number, number] | undefined;
822
927
  unit?: string | undefined;
823
928
  max?: number | undefined;
824
929
  min?: number | undefined;
825
- window?: [number, number] | undefined;
826
930
  slot?: "summary" | undefined;
827
931
  }, {
828
932
  type: "range_overlap";
@@ -834,10 +938,10 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
834
938
  title?: string | undefined;
835
939
  anchor?: string | undefined;
836
940
  postmortem?: boolean | undefined;
941
+ window?: [number, number] | undefined;
837
942
  unit?: string | undefined;
838
943
  max?: number | undefined;
839
944
  min?: number | undefined;
840
- window?: [number, number] | undefined;
841
945
  slot?: "summary" | undefined;
842
946
  }>, z.ZodObject<{
843
947
  type: z.ZodLiteral<"histogram">;
@@ -867,17 +971,17 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
867
971
  }, "strict", z.ZodTypeAny, {
868
972
  datasource?: string | undefined;
869
973
  kind?: string | undefined;
870
- query?: string | undefined;
871
974
  from?: string | undefined;
872
975
  to?: string | undefined;
976
+ query?: string | undefined;
873
977
  step?: string | undefined;
874
978
  artifact_id?: string | undefined;
875
979
  }, {
876
980
  datasource?: string | undefined;
877
981
  kind?: string | undefined;
878
- query?: string | undefined;
879
982
  from?: string | undefined;
880
983
  to?: string | undefined;
984
+ query?: string | undefined;
881
985
  step?: string | undefined;
882
986
  artifact_id?: string | undefined;
883
987
  }>>;
@@ -895,9 +999,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
895
999
  source?: {
896
1000
  datasource?: string | undefined;
897
1001
  kind?: string | undefined;
898
- query?: string | undefined;
899
1002
  from?: string | undefined;
900
1003
  to?: string | undefined;
1004
+ query?: string | undefined;
901
1005
  step?: string | undefined;
902
1006
  artifact_id?: string | undefined;
903
1007
  } | undefined;
@@ -918,9 +1022,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
918
1022
  source?: {
919
1023
  datasource?: string | undefined;
920
1024
  kind?: string | undefined;
921
- query?: string | undefined;
922
1025
  from?: string | undefined;
923
1026
  to?: string | undefined;
1027
+ query?: string | undefined;
924
1028
  step?: string | undefined;
925
1029
  artifact_id?: string | undefined;
926
1030
  } | undefined;
@@ -945,16 +1049,16 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
945
1049
  job: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
946
1050
  url: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
947
1051
  }, "strict", z.ZodTypeAny, {
948
- ref: string;
949
1052
  result: "pending" | "success" | "failure" | "cancelled";
1053
+ ref: string;
950
1054
  at?: string | undefined;
951
1055
  url?: string | undefined;
952
1056
  sha?: string | undefined;
953
1057
  trigger?: string | undefined;
954
1058
  job?: string | undefined;
955
1059
  }, {
956
- ref: string;
957
1060
  result: "pending" | "success" | "failure" | "cancelled";
1061
+ ref: string;
958
1062
  at?: string | undefined;
959
1063
  url?: string | undefined;
960
1064
  sha?: string | undefined;
@@ -1001,8 +1105,8 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
1001
1105
  }, "strict", z.ZodTypeAny, {
1002
1106
  type: "run_history";
1003
1107
  runs: {
1004
- ref: string;
1005
1108
  result: "pending" | "success" | "failure" | "cancelled";
1109
+ ref: string;
1006
1110
  at?: string | undefined;
1007
1111
  url?: string | undefined;
1008
1112
  sha?: string | undefined;
@@ -1031,8 +1135,8 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
1031
1135
  }, {
1032
1136
  type: "run_history";
1033
1137
  runs: {
1034
- ref: string;
1035
1138
  result: "pending" | "success" | "failure" | "cancelled";
1139
+ ref: string;
1036
1140
  at?: string | undefined;
1037
1141
  url?: string | undefined;
1038
1142
  sha?: string | undefined;
@@ -1123,6 +1227,108 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
1123
1227
  postmortem?: boolean | undefined;
1124
1228
  repo?: string | undefined;
1125
1229
  slot?: "summary" | undefined;
1230
+ }>, z.ZodObject<{
1231
+ type: z.ZodLiteral<"log_lines">;
1232
+ title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1233
+ source: z.ZodOptional<z.ZodObject<{
1234
+ kind: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1235
+ datasource: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1236
+ query: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1237
+ from: z.ZodOptional<z.ZodString>;
1238
+ to: z.ZodOptional<z.ZodString>;
1239
+ }, "strict", z.ZodTypeAny, {
1240
+ datasource?: string | undefined;
1241
+ kind?: string | undefined;
1242
+ from?: string | undefined;
1243
+ to?: string | undefined;
1244
+ query?: string | undefined;
1245
+ }, {
1246
+ datasource?: string | undefined;
1247
+ kind?: string | undefined;
1248
+ from?: string | undefined;
1249
+ to?: string | undefined;
1250
+ query?: string | undefined;
1251
+ }>>;
1252
+ matched: z.ZodNumber;
1253
+ scanned: z.ZodOptional<z.ZodNumber>;
1254
+ event_at: z.ZodOptional<z.ZodString>;
1255
+ lines: z.ZodOptional<z.ZodArray<z.ZodObject<{
1256
+ time: z.ZodString;
1257
+ level: z.ZodEnum<["error", "warn", "info", "debug", "other"]>;
1258
+ text: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
1259
+ fields: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>, Record<string, string>, Record<string, string>>>;
1260
+ relation: z.ZodOptional<z.ZodEnum<["matches_event", "context", "unrelated"]>>;
1261
+ note: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1262
+ }, "strict", z.ZodTypeAny, {
1263
+ text: string;
1264
+ level: "other" | "error" | "warn" | "info" | "debug";
1265
+ time: string;
1266
+ fields?: Record<string, string> | undefined;
1267
+ relation?: "context" | "matches_event" | "unrelated" | undefined;
1268
+ note?: string | undefined;
1269
+ }, {
1270
+ text: string;
1271
+ level: "other" | "error" | "warn" | "info" | "debug";
1272
+ time: string;
1273
+ fields?: Record<string, string> | undefined;
1274
+ relation?: "context" | "matches_event" | "unrelated" | undefined;
1275
+ note?: string | undefined;
1276
+ }>, "many">>;
1277
+ lines_not_shown: z.ZodOptional<z.ZodNumber>;
1278
+ } & {
1279
+ slot: z.ZodOptional<z.ZodLiteral<"summary">>;
1280
+ anchor: z.ZodOptional<z.ZodString>;
1281
+ postmortem: z.ZodOptional<z.ZodBoolean>;
1282
+ }, "strict", z.ZodTypeAny, {
1283
+ type: "log_lines";
1284
+ matched: number;
1285
+ title?: string | undefined;
1286
+ anchor?: string | undefined;
1287
+ source?: {
1288
+ datasource?: string | undefined;
1289
+ kind?: string | undefined;
1290
+ from?: string | undefined;
1291
+ to?: string | undefined;
1292
+ query?: string | undefined;
1293
+ } | undefined;
1294
+ postmortem?: boolean | undefined;
1295
+ lines?: {
1296
+ text: string;
1297
+ level: "other" | "error" | "warn" | "info" | "debug";
1298
+ time: string;
1299
+ fields?: Record<string, string> | undefined;
1300
+ relation?: "context" | "matches_event" | "unrelated" | undefined;
1301
+ note?: string | undefined;
1302
+ }[] | undefined;
1303
+ scanned?: number | undefined;
1304
+ event_at?: string | undefined;
1305
+ lines_not_shown?: number | undefined;
1306
+ slot?: "summary" | undefined;
1307
+ }, {
1308
+ type: "log_lines";
1309
+ matched: number;
1310
+ title?: string | undefined;
1311
+ anchor?: string | undefined;
1312
+ source?: {
1313
+ datasource?: string | undefined;
1314
+ kind?: string | undefined;
1315
+ from?: string | undefined;
1316
+ to?: string | undefined;
1317
+ query?: string | undefined;
1318
+ } | undefined;
1319
+ postmortem?: boolean | undefined;
1320
+ lines?: {
1321
+ text: string;
1322
+ level: "other" | "error" | "warn" | "info" | "debug";
1323
+ time: string;
1324
+ fields?: Record<string, string> | undefined;
1325
+ relation?: "context" | "matches_event" | "unrelated" | undefined;
1326
+ note?: string | undefined;
1327
+ }[] | undefined;
1328
+ scanned?: number | undefined;
1329
+ event_at?: string | undefined;
1330
+ lines_not_shown?: number | undefined;
1331
+ slot?: "summary" | undefined;
1126
1332
  }>]>;
1127
1333
  /**
1128
1334
  * The light check the timeline tools apply to `blocks`. The full schema above
@@ -1131,11 +1337,11 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
1131
1337
  * type is one the API accepts. tellagen_build_figure does the full check.
1132
1338
  */
1133
1339
  export declare const timelineBlockRefSchema: z.ZodObject<{
1134
- type: z.ZodEnum<["stats", "compare", "trend", "table", "checks", "changes", "range_overlap", "histogram", "run_history", "diff"]>;
1340
+ type: z.ZodEnum<["stats", "compare", "trend", "table", "checks", "changes", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
1135
1341
  }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
1136
- type: z.ZodEnum<["stats", "compare", "trend", "table", "checks", "changes", "range_overlap", "histogram", "run_history", "diff"]>;
1342
+ type: z.ZodEnum<["stats", "compare", "trend", "table", "checks", "changes", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
1137
1343
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
1138
- type: z.ZodEnum<["stats", "compare", "trend", "table", "checks", "changes", "range_overlap", "histogram", "run_history", "diff"]>;
1344
+ type: z.ZodEnum<["stats", "compare", "trend", "table", "checks", "changes", "range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
1139
1345
  }, z.ZodTypeAny, "passthrough">>;
1140
1346
  /** What tellagen_build_figure accepts. */
1141
1347
  export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -1150,12 +1356,12 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1150
1356
  value: string;
1151
1357
  label: string;
1152
1358
  caption?: string | undefined;
1153
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
1359
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
1154
1360
  }, {
1155
1361
  value: string;
1156
1362
  label: string;
1157
1363
  caption?: string | undefined;
1158
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
1364
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
1159
1365
  }>, "many">;
1160
1366
  }, "strict", z.ZodTypeAny, {
1161
1367
  type: "stats";
@@ -1163,7 +1369,7 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1163
1369
  value: string;
1164
1370
  label: string;
1165
1371
  caption?: string | undefined;
1166
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
1372
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
1167
1373
  }[];
1168
1374
  title?: string | undefined;
1169
1375
  }, {
@@ -1172,7 +1378,7 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1172
1378
  value: string;
1173
1379
  label: string;
1174
1380
  caption?: string | undefined;
1175
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
1381
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
1176
1382
  }[];
1177
1383
  title?: string | undefined;
1178
1384
  }>, z.ZodObject<{
@@ -1289,11 +1495,11 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1289
1495
  t: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
1290
1496
  v: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
1291
1497
  }, "strict", z.ZodTypeAny, {
1292
- t: string | number;
1293
1498
  v: string | number | null;
1294
- }, {
1295
1499
  t: string | number;
1500
+ }, {
1296
1501
  v: string | number | null;
1502
+ t: string | number;
1297
1503
  }>, "many">>;
1298
1504
  events: z.ZodOptional<z.ZodArray<z.ZodObject<{
1299
1505
  at: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
@@ -1340,17 +1546,17 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1340
1546
  }, "strict", z.ZodTypeAny, {
1341
1547
  datasource?: string | undefined;
1342
1548
  kind?: string | undefined;
1343
- query?: string | undefined;
1344
1549
  from?: string | undefined;
1345
1550
  to?: string | undefined;
1551
+ query?: string | undefined;
1346
1552
  step?: string | undefined;
1347
1553
  artifact_id?: string | undefined;
1348
1554
  }, {
1349
1555
  datasource?: string | undefined;
1350
1556
  kind?: string | undefined;
1351
- query?: string | undefined;
1352
1557
  from?: string | undefined;
1353
1558
  to?: string | undefined;
1559
+ query?: string | undefined;
1354
1560
  step?: string | undefined;
1355
1561
  artifact_id?: string | undefined;
1356
1562
  }>>;
@@ -1365,9 +1571,9 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1365
1571
  source?: {
1366
1572
  datasource?: string | undefined;
1367
1573
  kind?: string | undefined;
1368
- query?: string | undefined;
1369
1574
  from?: string | undefined;
1370
1575
  to?: string | undefined;
1576
+ query?: string | undefined;
1371
1577
  step?: string | undefined;
1372
1578
  artifact_id?: string | undefined;
1373
1579
  } | undefined;
@@ -1385,8 +1591,8 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1385
1591
  i: number;
1386
1592
  }[] | undefined;
1387
1593
  points?: {
1388
- t: string | number;
1389
1594
  v: string | number | null;
1595
+ t: string | number;
1390
1596
  }[] | undefined;
1391
1597
  max_points?: number | undefined;
1392
1598
  precision?: number | undefined;
@@ -1401,9 +1607,9 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1401
1607
  source?: {
1402
1608
  datasource?: string | undefined;
1403
1609
  kind?: string | undefined;
1404
- query?: string | undefined;
1405
1610
  from?: string | undefined;
1406
1611
  to?: string | undefined;
1612
+ query?: string | undefined;
1407
1613
  step?: string | undefined;
1408
1614
  artifact_id?: string | undefined;
1409
1615
  } | undefined;
@@ -1421,8 +1627,8 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1421
1627
  i: number;
1422
1628
  }[] | undefined;
1423
1629
  points?: {
1424
- t: string | number;
1425
1630
  v: string | number | null;
1631
+ t: string | number;
1426
1632
  }[] | undefined;
1427
1633
  max_points?: number | undefined;
1428
1634
  precision?: number | undefined;
@@ -1503,31 +1709,31 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1503
1709
  note: z.ZodOptional<z.ZodString>;
1504
1710
  }, "strict", z.ZodTypeAny, {
1505
1711
  label: string;
1712
+ note?: string | undefined;
1506
1713
  from?: string | undefined;
1507
1714
  to?: string | undefined;
1508
- note?: string | undefined;
1509
1715
  }, {
1510
1716
  label: string;
1717
+ note?: string | undefined;
1511
1718
  from?: string | undefined;
1512
1719
  to?: string | undefined;
1513
- note?: string | undefined;
1514
1720
  }>, "many">;
1515
1721
  }, "strict", z.ZodTypeAny, {
1516
1722
  type: "changes";
1517
1723
  rows: {
1518
1724
  label: string;
1725
+ note?: string | undefined;
1519
1726
  from?: string | undefined;
1520
1727
  to?: string | undefined;
1521
- note?: string | undefined;
1522
1728
  }[];
1523
1729
  title?: string | undefined;
1524
1730
  }, {
1525
1731
  type: "changes";
1526
1732
  rows: {
1527
1733
  label: string;
1734
+ note?: string | undefined;
1528
1735
  from?: string | undefined;
1529
1736
  to?: string | undefined;
1530
- note?: string | undefined;
1531
1737
  }[];
1532
1738
  title?: string | undefined;
1533
1739
  }>, z.ZodObject<{
@@ -1558,10 +1764,10 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1558
1764
  to: number;
1559
1765
  }[];
1560
1766
  title?: string | undefined;
1767
+ window?: [number, number] | undefined;
1561
1768
  unit?: string | undefined;
1562
1769
  max?: number | undefined;
1563
1770
  min?: number | undefined;
1564
- window?: [number, number] | undefined;
1565
1771
  }, {
1566
1772
  type: "range_overlap";
1567
1773
  rows: {
@@ -1570,10 +1776,10 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1570
1776
  to: number;
1571
1777
  }[];
1572
1778
  title?: string | undefined;
1779
+ window?: [number, number] | undefined;
1573
1780
  unit?: string | undefined;
1574
1781
  max?: number | undefined;
1575
1782
  min?: number | undefined;
1576
- window?: [number, number] | undefined;
1577
1783
  }>, z.ZodObject<{
1578
1784
  type: z.ZodLiteral<"histogram">;
1579
1785
  title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -1617,17 +1823,17 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1617
1823
  }, "strict", z.ZodTypeAny, {
1618
1824
  datasource?: string | undefined;
1619
1825
  kind?: string | undefined;
1620
- query?: string | undefined;
1621
1826
  from?: string | undefined;
1622
1827
  to?: string | undefined;
1828
+ query?: string | undefined;
1623
1829
  step?: string | undefined;
1624
1830
  artifact_id?: string | undefined;
1625
1831
  }, {
1626
1832
  datasource?: string | undefined;
1627
1833
  kind?: string | undefined;
1628
- query?: string | undefined;
1629
1834
  from?: string | undefined;
1630
1835
  to?: string | undefined;
1836
+ query?: string | undefined;
1631
1837
  step?: string | undefined;
1632
1838
  artifact_id?: string | undefined;
1633
1839
  }>>;
@@ -1637,9 +1843,9 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1637
1843
  source?: {
1638
1844
  datasource?: string | undefined;
1639
1845
  kind?: string | undefined;
1640
- query?: string | undefined;
1641
1846
  from?: string | undefined;
1642
1847
  to?: string | undefined;
1848
+ query?: string | undefined;
1643
1849
  step?: string | undefined;
1644
1850
  artifact_id?: string | undefined;
1645
1851
  } | undefined;
@@ -1664,9 +1870,9 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1664
1870
  source?: {
1665
1871
  datasource?: string | undefined;
1666
1872
  kind?: string | undefined;
1667
- query?: string | undefined;
1668
1873
  from?: string | undefined;
1669
1874
  to?: string | undefined;
1875
+ query?: string | undefined;
1670
1876
  step?: string | undefined;
1671
1877
  artifact_id?: string | undefined;
1672
1878
  } | undefined;
@@ -1699,16 +1905,16 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1699
1905
  job: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1700
1906
  url: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
1701
1907
  }, "strict", z.ZodTypeAny, {
1702
- ref: string;
1703
1908
  result: "pending" | "success" | "failure" | "cancelled";
1909
+ ref: string;
1704
1910
  at?: string | undefined;
1705
1911
  url?: string | undefined;
1706
1912
  sha?: string | undefined;
1707
1913
  trigger?: string | undefined;
1708
1914
  job?: string | undefined;
1709
1915
  }, {
1710
- ref: string;
1711
1916
  result: "pending" | "success" | "failure" | "cancelled";
1917
+ ref: string;
1712
1918
  at?: string | undefined;
1713
1919
  url?: string | undefined;
1714
1920
  sha?: string | undefined;
@@ -1813,8 +2019,8 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1813
2019
  repo?: string | undefined;
1814
2020
  branch?: string | undefined;
1815
2021
  runs?: {
1816
- ref: string;
1817
2022
  result: "pending" | "success" | "failure" | "cancelled";
2023
+ ref: string;
1818
2024
  at?: string | undefined;
1819
2025
  url?: string | undefined;
1820
2026
  sha?: string | undefined;
@@ -1858,8 +2064,8 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1858
2064
  repo?: string | undefined;
1859
2065
  branch?: string | undefined;
1860
2066
  runs?: {
1861
- ref: string;
1862
2067
  result: "pending" | "success" | "failure" | "cancelled";
2068
+ ref: string;
1863
2069
  at?: string | undefined;
1864
2070
  url?: string | undefined;
1865
2071
  sha?: string | undefined;
@@ -1951,10 +2157,120 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1951
2157
  repo?: string | undefined;
1952
2158
  patch?: string | undefined;
1953
2159
  select_hunks?: number[] | undefined;
2160
+ }>, z.ZodObject<{
2161
+ type: z.ZodLiteral<"log_lines">;
2162
+ title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
2163
+ query: z.ZodOptional<z.ZodString>;
2164
+ datasource: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
2165
+ kind: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
2166
+ from: z.ZodOptional<z.ZodString>;
2167
+ to: z.ZodOptional<z.ZodString>;
2168
+ streams: z.ZodOptional<z.ZodUnknown>;
2169
+ entries: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
2170
+ matched: z.ZodOptional<z.ZodNumber>;
2171
+ scanned: z.ZodOptional<z.ZodNumber>;
2172
+ event_at: z.ZodOptional<z.ZodString>;
2173
+ match: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2174
+ marks: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
2175
+ contains: z.ZodOptional<z.ZodString>;
2176
+ field: z.ZodOptional<z.ZodObject<{
2177
+ key: z.ZodString;
2178
+ value: z.ZodString;
2179
+ }, "strict", z.ZodTypeAny, {
2180
+ value: string;
2181
+ key: string;
2182
+ }, {
2183
+ value: string;
2184
+ key: string;
2185
+ }>>;
2186
+ relation: z.ZodEnum<["matches_event", "context", "unrelated"]>;
2187
+ note: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
2188
+ }, "strict", z.ZodTypeAny, {
2189
+ relation: "context" | "matches_event" | "unrelated";
2190
+ field?: {
2191
+ value: string;
2192
+ key: string;
2193
+ } | undefined;
2194
+ note?: string | undefined;
2195
+ contains?: string | undefined;
2196
+ }, {
2197
+ relation: "context" | "matches_event" | "unrelated";
2198
+ field?: {
2199
+ value: string;
2200
+ key: string;
2201
+ } | undefined;
2202
+ note?: string | undefined;
2203
+ contains?: string | undefined;
2204
+ }>, {
2205
+ relation: "context" | "matches_event" | "unrelated";
2206
+ field?: {
2207
+ value: string;
2208
+ key: string;
2209
+ } | undefined;
2210
+ note?: string | undefined;
2211
+ contains?: string | undefined;
2212
+ }, {
2213
+ relation: "context" | "matches_event" | "unrelated";
2214
+ field?: {
2215
+ value: string;
2216
+ key: string;
2217
+ } | undefined;
2218
+ note?: string | undefined;
2219
+ contains?: string | undefined;
2220
+ }>, "many">>;
2221
+ field_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2222
+ }, "strict", z.ZodTypeAny, {
2223
+ type: "log_lines";
2224
+ entries?: Record<string, unknown>[] | undefined;
2225
+ title?: string | undefined;
2226
+ datasource?: string | undefined;
2227
+ kind?: string | undefined;
2228
+ match?: string[] | undefined;
2229
+ from?: string | undefined;
2230
+ to?: string | undefined;
2231
+ query?: string | undefined;
2232
+ marks?: {
2233
+ relation: "context" | "matches_event" | "unrelated";
2234
+ field?: {
2235
+ value: string;
2236
+ key: string;
2237
+ } | undefined;
2238
+ note?: string | undefined;
2239
+ contains?: string | undefined;
2240
+ }[] | undefined;
2241
+ matched?: number | undefined;
2242
+ scanned?: number | undefined;
2243
+ event_at?: string | undefined;
2244
+ streams?: unknown;
2245
+ field_keys?: string[] | undefined;
2246
+ }, {
2247
+ type: "log_lines";
2248
+ entries?: Record<string, unknown>[] | undefined;
2249
+ title?: string | undefined;
2250
+ datasource?: string | undefined;
2251
+ kind?: string | undefined;
2252
+ match?: string[] | undefined;
2253
+ from?: string | undefined;
2254
+ to?: string | undefined;
2255
+ query?: string | undefined;
2256
+ marks?: {
2257
+ relation: "context" | "matches_event" | "unrelated";
2258
+ field?: {
2259
+ value: string;
2260
+ key: string;
2261
+ } | undefined;
2262
+ note?: string | undefined;
2263
+ contains?: string | undefined;
2264
+ }[] | undefined;
2265
+ matched?: number | undefined;
2266
+ scanned?: number | undefined;
2267
+ event_at?: string | undefined;
2268
+ streams?: unknown;
2269
+ field_keys?: string[] | undefined;
1954
2270
  }>]>;
1955
2271
  export type FigureInput = z.infer<typeof figureInputSchema>;
1956
2272
  /** The four figure types whose fields the tool listing leaves to the guide. */
1957
- export declare const GUIDE_ONLY_FIGURE_TYPES: readonly ["range_overlap", "histogram", "run_history", "diff"];
2273
+ export declare const GUIDE_ONLY_FIGURE_TYPES: readonly ["range_overlap", "histogram", "run_history", "diff", "log_lines"];
1958
2274
  /**
1959
2275
  * The figure as tellagen_build_figure lists it. The six original types carry
1960
2276
  * their full schema; the four newer ones only their type, so the listing stays
@@ -1973,12 +2289,12 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
1973
2289
  value: string;
1974
2290
  label: string;
1975
2291
  caption?: string | undefined;
1976
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
2292
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
1977
2293
  }, {
1978
2294
  value: string;
1979
2295
  label: string;
1980
2296
  caption?: string | undefined;
1981
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
2297
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
1982
2298
  }>, "many">;
1983
2299
  }, "strict", z.ZodTypeAny, {
1984
2300
  type: "stats";
@@ -1986,7 +2302,7 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
1986
2302
  value: string;
1987
2303
  label: string;
1988
2304
  caption?: string | undefined;
1989
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
2305
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
1990
2306
  }[];
1991
2307
  title?: string | undefined;
1992
2308
  }, {
@@ -1995,7 +2311,7 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
1995
2311
  value: string;
1996
2312
  label: string;
1997
2313
  caption?: string | undefined;
1998
- tone?: "good" | "warn" | "bad" | "neutral" | undefined;
2314
+ tone?: "warn" | "good" | "bad" | "neutral" | undefined;
1999
2315
  }[];
2000
2316
  title?: string | undefined;
2001
2317
  }>, z.ZodObject<{
@@ -2112,11 +2428,11 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2112
2428
  t: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
2113
2429
  v: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
2114
2430
  }, "strict", z.ZodTypeAny, {
2115
- t: string | number;
2116
2431
  v: string | number | null;
2117
- }, {
2118
2432
  t: string | number;
2433
+ }, {
2119
2434
  v: string | number | null;
2435
+ t: string | number;
2120
2436
  }>, "many">>;
2121
2437
  events: z.ZodOptional<z.ZodArray<z.ZodObject<{
2122
2438
  at: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
@@ -2163,17 +2479,17 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2163
2479
  }, "strict", z.ZodTypeAny, {
2164
2480
  datasource?: string | undefined;
2165
2481
  kind?: string | undefined;
2166
- query?: string | undefined;
2167
2482
  from?: string | undefined;
2168
2483
  to?: string | undefined;
2484
+ query?: string | undefined;
2169
2485
  step?: string | undefined;
2170
2486
  artifact_id?: string | undefined;
2171
2487
  }, {
2172
2488
  datasource?: string | undefined;
2173
2489
  kind?: string | undefined;
2174
- query?: string | undefined;
2175
2490
  from?: string | undefined;
2176
2491
  to?: string | undefined;
2492
+ query?: string | undefined;
2177
2493
  step?: string | undefined;
2178
2494
  artifact_id?: string | undefined;
2179
2495
  }>>;
@@ -2188,9 +2504,9 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2188
2504
  source?: {
2189
2505
  datasource?: string | undefined;
2190
2506
  kind?: string | undefined;
2191
- query?: string | undefined;
2192
2507
  from?: string | undefined;
2193
2508
  to?: string | undefined;
2509
+ query?: string | undefined;
2194
2510
  step?: string | undefined;
2195
2511
  artifact_id?: string | undefined;
2196
2512
  } | undefined;
@@ -2208,8 +2524,8 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2208
2524
  i: number;
2209
2525
  }[] | undefined;
2210
2526
  points?: {
2211
- t: string | number;
2212
2527
  v: string | number | null;
2528
+ t: string | number;
2213
2529
  }[] | undefined;
2214
2530
  max_points?: number | undefined;
2215
2531
  precision?: number | undefined;
@@ -2224,9 +2540,9 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2224
2540
  source?: {
2225
2541
  datasource?: string | undefined;
2226
2542
  kind?: string | undefined;
2227
- query?: string | undefined;
2228
2543
  from?: string | undefined;
2229
2544
  to?: string | undefined;
2545
+ query?: string | undefined;
2230
2546
  step?: string | undefined;
2231
2547
  artifact_id?: string | undefined;
2232
2548
  } | undefined;
@@ -2244,8 +2560,8 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2244
2560
  i: number;
2245
2561
  }[] | undefined;
2246
2562
  points?: {
2247
- t: string | number;
2248
2563
  v: string | number | null;
2564
+ t: string | number;
2249
2565
  }[] | undefined;
2250
2566
  max_points?: number | undefined;
2251
2567
  precision?: number | undefined;
@@ -2326,39 +2642,39 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2326
2642
  note: z.ZodOptional<z.ZodString>;
2327
2643
  }, "strict", z.ZodTypeAny, {
2328
2644
  label: string;
2645
+ note?: string | undefined;
2329
2646
  from?: string | undefined;
2330
2647
  to?: string | undefined;
2331
- note?: string | undefined;
2332
2648
  }, {
2333
2649
  label: string;
2650
+ note?: string | undefined;
2334
2651
  from?: string | undefined;
2335
2652
  to?: string | undefined;
2336
- note?: string | undefined;
2337
2653
  }>, "many">;
2338
2654
  }, "strict", z.ZodTypeAny, {
2339
2655
  type: "changes";
2340
2656
  rows: {
2341
2657
  label: string;
2658
+ note?: string | undefined;
2342
2659
  from?: string | undefined;
2343
2660
  to?: string | undefined;
2344
- note?: string | undefined;
2345
2661
  }[];
2346
2662
  title?: string | undefined;
2347
2663
  }, {
2348
2664
  type: "changes";
2349
2665
  rows: {
2350
2666
  label: string;
2667
+ note?: string | undefined;
2351
2668
  from?: string | undefined;
2352
2669
  to?: string | undefined;
2353
- note?: string | undefined;
2354
2670
  }[];
2355
2671
  title?: string | undefined;
2356
2672
  }>, z.ZodObject<{
2357
- type: z.ZodEnum<["range_overlap", "histogram", "run_history", "diff"]>;
2673
+ type: z.ZodEnum<["range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
2358
2674
  }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
2359
- type: z.ZodEnum<["range_overlap", "histogram", "run_history", "diff"]>;
2675
+ type: z.ZodEnum<["range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
2360
2676
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
2361
- type: z.ZodEnum<["range_overlap", "histogram", "run_history", "diff"]>;
2677
+ type: z.ZodEnum<["range_overlap", "histogram", "run_history", "diff", "log_lines"]>;
2362
2678
  }, z.ZodTypeAny, "passthrough">>]>;
2363
2679
  export type BuildFigureInput = {
2364
2680
  placement: FigurePlacement;
@@ -2390,6 +2706,12 @@ export type FigureOptions = {
2390
2706
  figureExtras?: boolean;
2391
2707
  /** The server lists diff_lines_v1: a diff may carry unchanged lines and line numbers. */
2392
2708
  diffLines?: boolean;
2709
+ /** The server lists log_lines_v1: it takes a log_lines figure. */
2710
+ logLines?: boolean;
2711
+ /** The window of the run, the default range of a log_lines figure. */
2712
+ window?: RunWindow;
2713
+ /** The clock, for the end of an open window. */
2714
+ now?: Date;
2393
2715
  };
2394
2716
  /**
2395
2717
  * A diff block as a server without diff_lines_v1 takes it: no unchanged lines
@@ -2408,6 +2730,8 @@ export declare function withoutFigureExtrasInBlock(block: unknown): {
2408
2730
  block: unknown;
2409
2731
  what: string[];
2410
2732
  };
2733
+ /** Whether a block is a log_lines figure. */
2734
+ export declare function isLogLinesBlock(block: unknown): boolean;
2411
2735
  /**
2412
2736
  * Turns the numbers an agent already read from a tool result into a figure
2413
2737
  * Tellagen accepts. It reshapes and checks. It has no data source of its own