@tellagen/mcp-server 0.5.0 → 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 (85) hide show
  1. package/README.md +32 -6
  2. package/SKILL.md +44 -7
  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 +131 -106
  18. package/dist/diagnosis-structure.js +64 -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 +447 -123
  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-state.d.ts +37 -0
  44. package/dist/run-state.js +14 -0
  45. package/dist/run-state.js.map +1 -1
  46. package/dist/run-window.d.ts +59 -0
  47. package/dist/run-window.js +141 -0
  48. package/dist/run-window.js.map +1 -0
  49. package/dist/server.d.ts +1 -1
  50. package/dist/server.js +1 -1
  51. package/dist/session.d.ts +13 -0
  52. package/dist/session.js +32 -0
  53. package/dist/session.js.map +1 -1
  54. package/dist/source-bases.d.ts +75 -0
  55. package/dist/source-bases.js +125 -0
  56. package/dist/source-bases.js.map +1 -0
  57. package/dist/tool-report.d.ts +2 -0
  58. package/dist/tool-report.js +3 -0
  59. package/dist/tool-report.js.map +1 -0
  60. package/dist/tools/catalog.js +1 -0
  61. package/dist/tools/catalog.js.map +1 -1
  62. package/dist/tools/datasources.js +70 -13
  63. package/dist/tools/datasources.js.map +1 -1
  64. package/dist/tools/diagnostics.js +85 -2
  65. package/dist/tools/diagnostics.js.map +1 -1
  66. package/dist/tools/figures.d.ts +2 -2
  67. package/dist/tools/figures.js +29 -7
  68. package/dist/tools/figures.js.map +1 -1
  69. package/dist/tools/findings.d.ts +8 -0
  70. package/dist/tools/findings.js +63 -2
  71. package/dist/tools/findings.js.map +1 -1
  72. package/dist/tools/investigations.d.ts +1 -1
  73. package/dist/tools/investigations.js +46 -4
  74. package/dist/tools/investigations.js.map +1 -1
  75. package/dist/tools/postmortem-runbooks.d.ts +20 -20
  76. package/dist/tools/source-links.d.ts +23 -0
  77. package/dist/tools/source-links.js +53 -16
  78. package/dist/tools/source-links.js.map +1 -1
  79. package/dist/tools/timeline.js +13 -2
  80. package/dist/tools/timeline.js.map +1 -1
  81. package/dist/version.d.ts +2 -2
  82. package/dist/version.js +3 -1
  83. package/dist/version.js.map +1 -1
  84. package/package.json +1 -1
  85. package/server.json +5 -5
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">;
@@ -131,19 +142,19 @@ export declare const histogramBlockSchema: z.ZodObject<{
131
142
  step: z.ZodOptional<z.ZodString>;
132
143
  artifact_id: z.ZodOptional<z.ZodString>;
133
144
  }, "strict", z.ZodTypeAny, {
134
- kind?: string | undefined;
135
145
  datasource?: string | undefined;
136
- query?: string | undefined;
146
+ kind?: 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
- kind?: string | undefined;
143
153
  datasource?: string | undefined;
144
- query?: string | undefined;
154
+ kind?: 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
  }>>;
@@ -154,11 +165,11 @@ export declare const histogramBlockSchema: z.ZodObject<{
154
165
  edges: number[];
155
166
  title?: string | undefined;
156
167
  source?: {
157
- kind?: string | undefined;
158
168
  datasource?: string | undefined;
159
- query?: string | undefined;
169
+ kind?: 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;
@@ -174,11 +185,11 @@ export declare const histogramBlockSchema: z.ZodObject<{
174
185
  edges: number[];
175
186
  title?: string | undefined;
176
187
  source?: {
177
- kind?: string | undefined;
178
188
  datasource?: string | undefined;
179
- query?: string | undefined;
189
+ kind?: 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;
@@ -575,19 +679,19 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
575
679
  step: z.ZodOptional<z.ZodString>;
576
680
  artifact_id: z.ZodOptional<z.ZodString>;
577
681
  }, "strict", z.ZodTypeAny, {
578
- kind?: string | undefined;
579
682
  datasource?: string | undefined;
580
- query?: string | undefined;
683
+ kind?: 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
- kind?: string | undefined;
587
690
  datasource?: string | undefined;
588
- query?: string | undefined;
691
+ kind?: 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
  }>>;
@@ -601,11 +705,11 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
601
705
  title?: string | undefined;
602
706
  anchor?: string | undefined;
603
707
  source?: {
604
- kind?: string | undefined;
605
708
  datasource?: string | undefined;
606
- query?: string | undefined;
709
+ kind?: 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;
@@ -629,11 +733,11 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
629
733
  title?: string | undefined;
630
734
  anchor?: string | undefined;
631
735
  source?: {
632
- kind?: string | undefined;
633
736
  datasource?: string | undefined;
634
- query?: string | undefined;
737
+ kind?: 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">;
@@ -865,19 +969,19 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
865
969
  step: z.ZodOptional<z.ZodString>;
866
970
  artifact_id: z.ZodOptional<z.ZodString>;
867
971
  }, "strict", z.ZodTypeAny, {
868
- kind?: string | undefined;
869
972
  datasource?: string | undefined;
870
- query?: string | undefined;
973
+ kind?: 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
- kind?: string | undefined;
877
980
  datasource?: string | undefined;
878
- query?: string | undefined;
981
+ kind?: 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
  }>>;
@@ -893,11 +997,11 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
893
997
  title?: string | undefined;
894
998
  anchor?: string | undefined;
895
999
  source?: {
896
- kind?: string | undefined;
897
1000
  datasource?: string | undefined;
898
- query?: string | undefined;
1001
+ kind?: 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;
@@ -916,11 +1020,11 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
916
1020
  title?: string | undefined;
917
1021
  anchor?: string | undefined;
918
1022
  source?: {
919
- kind?: string | undefined;
920
1023
  datasource?: string | undefined;
921
- query?: string | undefined;
1024
+ kind?: 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]>;
@@ -1338,19 +1544,19 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1338
1544
  step: z.ZodOptional<z.ZodString>;
1339
1545
  artifact_id: z.ZodOptional<z.ZodString>;
1340
1546
  }, "strict", z.ZodTypeAny, {
1341
- kind?: string | undefined;
1342
1547
  datasource?: string | undefined;
1343
- query?: string | undefined;
1548
+ kind?: 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
- kind?: string | undefined;
1350
1555
  datasource?: string | undefined;
1351
- query?: string | undefined;
1556
+ kind?: 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
  }>>;
@@ -1358,12 +1564,16 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1358
1564
  type: "trend";
1359
1565
  reduce?: "max" | "min" | "mean" | "last" | undefined;
1360
1566
  title?: string | undefined;
1567
+ events?: {
1568
+ at: string | number;
1569
+ label: string;
1570
+ }[] | undefined;
1361
1571
  source?: {
1362
- kind?: string | undefined;
1363
1572
  datasource?: string | undefined;
1364
- query?: string | undefined;
1573
+ kind?: string | undefined;
1365
1574
  from?: string | undefined;
1366
1575
  to?: string | undefined;
1576
+ query?: string | undefined;
1367
1577
  step?: string | undefined;
1368
1578
  artifact_id?: string | undefined;
1369
1579
  } | undefined;
@@ -1381,12 +1591,8 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1381
1591
  i: number;
1382
1592
  }[] | undefined;
1383
1593
  points?: {
1384
- t: string | number;
1385
1594
  v: string | number | null;
1386
- }[] | undefined;
1387
- events?: {
1388
- at: string | number;
1389
- label: string;
1595
+ t: string | number;
1390
1596
  }[] | undefined;
1391
1597
  max_points?: number | undefined;
1392
1598
  precision?: number | undefined;
@@ -1394,12 +1600,16 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1394
1600
  type: "trend";
1395
1601
  reduce?: "max" | "min" | "mean" | "last" | undefined;
1396
1602
  title?: string | undefined;
1603
+ events?: {
1604
+ at: string | number;
1605
+ label: string;
1606
+ }[] | undefined;
1397
1607
  source?: {
1398
- kind?: string | undefined;
1399
1608
  datasource?: string | undefined;
1400
- query?: string | undefined;
1609
+ kind?: string | undefined;
1401
1610
  from?: string | undefined;
1402
1611
  to?: string | undefined;
1612
+ query?: string | undefined;
1403
1613
  step?: string | undefined;
1404
1614
  artifact_id?: string | undefined;
1405
1615
  } | undefined;
@@ -1417,12 +1627,8 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1417
1627
  i: number;
1418
1628
  }[] | undefined;
1419
1629
  points?: {
1420
- t: string | number;
1421
1630
  v: string | number | null;
1422
- }[] | undefined;
1423
- events?: {
1424
- at: string | number;
1425
- label: string;
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>>;
@@ -1615,19 +1821,19 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1615
1821
  step: z.ZodOptional<z.ZodString>;
1616
1822
  artifact_id: z.ZodOptional<z.ZodString>;
1617
1823
  }, "strict", z.ZodTypeAny, {
1618
- kind?: string | undefined;
1619
1824
  datasource?: string | undefined;
1620
- query?: string | undefined;
1825
+ kind?: 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
- kind?: string | undefined;
1627
1832
  datasource?: string | undefined;
1628
- query?: string | undefined;
1833
+ kind?: 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
  }>>;
@@ -1635,11 +1841,11 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1635
1841
  type: "histogram";
1636
1842
  title?: string | undefined;
1637
1843
  source?: {
1638
- kind?: string | undefined;
1639
1844
  datasource?: string | undefined;
1640
- query?: string | undefined;
1845
+ kind?: 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;
@@ -1662,11 +1868,11 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1662
1868
  type: "histogram";
1663
1869
  title?: string | undefined;
1664
1870
  source?: {
1665
- kind?: string | undefined;
1666
1871
  datasource?: string | undefined;
1667
- query?: string | undefined;
1872
+ kind?: 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]>;
@@ -2161,19 +2477,19 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2161
2477
  step: z.ZodOptional<z.ZodString>;
2162
2478
  artifact_id: z.ZodOptional<z.ZodString>;
2163
2479
  }, "strict", z.ZodTypeAny, {
2164
- kind?: string | undefined;
2165
2480
  datasource?: string | undefined;
2166
- query?: string | undefined;
2481
+ kind?: 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
- kind?: string | undefined;
2173
2488
  datasource?: string | undefined;
2174
- query?: string | undefined;
2489
+ kind?: 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
  }>>;
@@ -2181,12 +2497,16 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2181
2497
  type: "trend";
2182
2498
  reduce?: "max" | "min" | "mean" | "last" | undefined;
2183
2499
  title?: string | undefined;
2500
+ events?: {
2501
+ at: string | number;
2502
+ label: string;
2503
+ }[] | undefined;
2184
2504
  source?: {
2185
- kind?: string | undefined;
2186
2505
  datasource?: string | undefined;
2187
- query?: string | undefined;
2506
+ kind?: string | undefined;
2188
2507
  from?: string | undefined;
2189
2508
  to?: string | undefined;
2509
+ query?: string | undefined;
2190
2510
  step?: string | undefined;
2191
2511
  artifact_id?: string | undefined;
2192
2512
  } | undefined;
@@ -2204,12 +2524,8 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2204
2524
  i: number;
2205
2525
  }[] | undefined;
2206
2526
  points?: {
2207
- t: string | number;
2208
2527
  v: string | number | null;
2209
- }[] | undefined;
2210
- events?: {
2211
- at: string | number;
2212
- label: string;
2528
+ t: string | number;
2213
2529
  }[] | undefined;
2214
2530
  max_points?: number | undefined;
2215
2531
  precision?: number | undefined;
@@ -2217,12 +2533,16 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2217
2533
  type: "trend";
2218
2534
  reduce?: "max" | "min" | "mean" | "last" | undefined;
2219
2535
  title?: string | undefined;
2536
+ events?: {
2537
+ at: string | number;
2538
+ label: string;
2539
+ }[] | undefined;
2220
2540
  source?: {
2221
- kind?: string | undefined;
2222
2541
  datasource?: string | undefined;
2223
- query?: string | undefined;
2542
+ kind?: string | undefined;
2224
2543
  from?: string | undefined;
2225
2544
  to?: string | undefined;
2545
+ query?: string | undefined;
2226
2546
  step?: string | undefined;
2227
2547
  artifact_id?: string | undefined;
2228
2548
  } | undefined;
@@ -2240,12 +2560,8 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2240
2560
  i: number;
2241
2561
  }[] | undefined;
2242
2562
  points?: {
2243
- t: string | number;
2244
2563
  v: string | number | null;
2245
- }[] | undefined;
2246
- events?: {
2247
- at: string | number;
2248
- label: string;
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