@tellagen/mcp-server 0.4.2 → 0.5.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 (180) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +334 -101
  3. package/SKILL.md +83 -17
  4. package/contracts/mcp-protocol.json +155 -0
  5. package/contracts/runbooks/manifest.json +26 -6
  6. package/contracts/runbooks/v2/cause-lead.guidance.json +37 -0
  7. package/contracts/runbooks/v2/client-protocol.json +926 -0
  8. package/contracts/runbooks/v2/client-writes.guidance.json +42 -0
  9. package/contracts/runbooks/v2/fixtures/timeline-event-blocks-rejected.json +30 -5
  10. package/contracts/runbooks/v2/result-summary.guidance.json +21 -0
  11. package/contracts/runbooks/v2/timeline-event-blocks.schema.json +18 -11
  12. package/contracts/tellagen-runbook-contracts.json +4 -4
  13. package/dist/active-run.d.ts +29 -0
  14. package/dist/active-run.js +67 -0
  15. package/dist/active-run.js.map +1 -0
  16. package/dist/bootstrap.d.ts +20 -0
  17. package/dist/bootstrap.js +29 -0
  18. package/dist/bootstrap.js.map +1 -0
  19. package/dist/cause-lead.d.ts +25 -0
  20. package/dist/cause-lead.js +145 -0
  21. package/dist/cause-lead.js.map +1 -0
  22. package/dist/cli/auth.d.ts +22 -0
  23. package/dist/cli/auth.js +207 -0
  24. package/dist/cli/auth.js.map +1 -0
  25. package/dist/cli/io.d.ts +16 -0
  26. package/dist/cli/io.js +53 -0
  27. package/dist/cli/io.js.map +1 -0
  28. package/dist/cli/listen-guard.d.ts +12 -0
  29. package/dist/cli/listen-guard.js +50 -0
  30. package/dist/cli/listen-guard.js.map +1 -0
  31. package/dist/cli/listen.d.ts +28 -0
  32. package/dist/cli/listen.js +205 -0
  33. package/dist/cli/listen.js.map +1 -0
  34. package/dist/cli/main.d.ts +3 -0
  35. package/dist/cli/main.js +53 -0
  36. package/dist/cli/main.js.map +1 -0
  37. package/dist/cli/trace-hook.d.ts +23 -0
  38. package/dist/cli/trace-hook.js +99 -0
  39. package/dist/cli/trace-hook.js.map +1 -0
  40. package/dist/client.d.ts +92 -6
  41. package/dist/client.js +300 -23
  42. package/dist/client.js.map +1 -1
  43. package/dist/config.d.ts +17 -0
  44. package/dist/config.js +38 -0
  45. package/dist/config.js.map +1 -0
  46. package/dist/credentials.d.ts +120 -0
  47. package/dist/credentials.js +363 -0
  48. package/dist/credentials.js.map +1 -0
  49. package/dist/diagnosis-structure.d.ts +207 -147
  50. package/dist/diagnosis-structure.js +142 -1
  51. package/dist/diagnosis-structure.js.map +1 -1
  52. package/dist/diff-figure.d.ts +56 -0
  53. package/dist/diff-figure.js +276 -0
  54. package/dist/diff-figure.js.map +1 -0
  55. package/dist/errors.d.ts +21 -0
  56. package/dist/errors.js +60 -0
  57. package/dist/errors.js.map +1 -1
  58. package/dist/figures.d.ts +281 -201
  59. package/dist/figures.js +189 -47
  60. package/dist/figures.js.map +1 -1
  61. package/dist/guide-resources.d.ts +28 -0
  62. package/dist/guide-resources.js +81 -0
  63. package/dist/guide-resources.js.map +1 -0
  64. package/dist/heartbeat.d.ts +24 -0
  65. package/dist/heartbeat.js +94 -0
  66. package/dist/heartbeat.js.map +1 -0
  67. package/dist/home.d.ts +8 -0
  68. package/dist/home.js +14 -0
  69. package/dist/home.js.map +1 -0
  70. package/dist/identity.d.ts +32 -0
  71. package/dist/identity.js +83 -0
  72. package/dist/identity.js.map +1 -0
  73. package/dist/index.js +46 -14
  74. package/dist/index.js.map +1 -1
  75. package/dist/listen-config.d.ts +67 -0
  76. package/dist/listen-config.js +83 -0
  77. package/dist/listen-config.js.map +1 -0
  78. package/dist/listen-probe.d.ts +57 -0
  79. package/dist/listen-probe.js +158 -0
  80. package/dist/listen-probe.js.map +1 -0
  81. package/dist/listen-rules.d.ts +88 -0
  82. package/dist/listen-rules.js +252 -0
  83. package/dist/listen-rules.js.map +1 -0
  84. package/dist/listen-settings.d.ts +18 -0
  85. package/dist/listen-settings.js +50 -0
  86. package/dist/listen-settings.js.map +1 -0
  87. package/dist/listen-wrap.d.ts +21 -0
  88. package/dist/listen-wrap.js +52 -0
  89. package/dist/listen-wrap.js.map +1 -0
  90. package/dist/listener.d.ts +195 -0
  91. package/dist/listener.js +600 -0
  92. package/dist/listener.js.map +1 -0
  93. package/dist/open-run.d.ts +2 -0
  94. package/dist/open-run.js +5 -0
  95. package/dist/open-run.js.map +1 -0
  96. package/dist/prompts.d.ts +12 -0
  97. package/dist/prompts.js +37 -0
  98. package/dist/prompts.js.map +1 -0
  99. package/dist/redact.d.ts +13 -0
  100. package/dist/redact.js +76 -0
  101. package/dist/redact.js.map +1 -0
  102. package/dist/run-events.d.ts +54 -0
  103. package/dist/run-events.js +210 -0
  104. package/dist/run-events.js.map +1 -0
  105. package/dist/run-state.d.ts +184 -0
  106. package/dist/run-state.js +207 -0
  107. package/dist/run-state.js.map +1 -0
  108. package/dist/server.d.ts +22 -2
  109. package/dist/server.js +137 -29
  110. package/dist/server.js.map +1 -1
  111. package/dist/session.d.ts +86 -0
  112. package/dist/session.js +155 -0
  113. package/dist/session.js.map +1 -0
  114. package/dist/shell-rules.d.ts +49 -0
  115. package/dist/shell-rules.js +335 -0
  116. package/dist/shell-rules.js.map +1 -0
  117. package/dist/signin-index.d.ts +164 -0
  118. package/dist/signin-index.js +116 -0
  119. package/dist/signin-index.js.map +1 -0
  120. package/dist/signin.d.ts +169 -0
  121. package/dist/signin.js +541 -0
  122. package/dist/signin.js.map +1 -0
  123. package/dist/start.d.ts +7 -6
  124. package/dist/start.js +14 -7
  125. package/dist/start.js.map +1 -1
  126. package/dist/tools/catalog.d.ts +44 -0
  127. package/dist/tools/catalog.js +105 -0
  128. package/dist/tools/catalog.js.map +1 -0
  129. package/dist/tools/causes.d.ts +6 -6
  130. package/dist/tools/causes.js +4 -5
  131. package/dist/tools/causes.js.map +1 -1
  132. package/dist/tools/context.js +5 -5
  133. package/dist/tools/context.js.map +1 -1
  134. package/dist/tools/datasources.js +1 -1
  135. package/dist/tools/datasources.js.map +1 -1
  136. package/dist/tools/diagnostics.js +2 -2
  137. package/dist/tools/diagnostics.js.map +1 -1
  138. package/dist/tools/figures.d.ts +3 -2
  139. package/dist/tools/figures.js +38 -13
  140. package/dist/tools/figures.js.map +1 -1
  141. package/dist/tools/findings.d.ts +28 -0
  142. package/dist/tools/findings.js +75 -12
  143. package/dist/tools/findings.js.map +1 -1
  144. package/dist/tools/incidents.js +5 -5
  145. package/dist/tools/incidents.js.map +1 -1
  146. package/dist/tools/index.d.ts +19 -2
  147. package/dist/tools/index.js +115 -14
  148. package/dist/tools/index.js.map +1 -1
  149. package/dist/tools/investigations.d.ts +54 -0
  150. package/dist/tools/investigations.js +369 -68
  151. package/dist/tools/investigations.js.map +1 -1
  152. package/dist/tools/next.d.ts +20 -0
  153. package/dist/tools/next.js +136 -0
  154. package/dist/tools/next.js.map +1 -0
  155. package/dist/tools/postmortem-runbooks.d.ts +52 -52
  156. package/dist/tools/postmortem-runbooks.js +3 -10
  157. package/dist/tools/postmortem-runbooks.js.map +1 -1
  158. package/dist/tools/resume.d.ts +5 -0
  159. package/dist/tools/resume.js +136 -0
  160. package/dist/tools/resume.js.map +1 -0
  161. package/dist/tools/signin.d.ts +12 -0
  162. package/dist/tools/signin.js +54 -0
  163. package/dist/tools/signin.js.map +1 -0
  164. package/dist/tools/source-links.js +5 -3
  165. package/dist/tools/source-links.js.map +1 -1
  166. package/dist/tools/timeline.js +57 -11
  167. package/dist/tools/timeline.js.map +1 -1
  168. package/dist/trace-record.d.ts +36 -0
  169. package/dist/trace-record.js +283 -0
  170. package/dist/trace-record.js.map +1 -0
  171. package/dist/version.d.ts +10 -2
  172. package/dist/version.js +20 -1
  173. package/dist/version.js.map +1 -1
  174. package/package.json +23 -3
  175. package/server.json +5 -5
  176. package/contracts/runbooks/v1/fixtures/global-runbook.json +0 -7
  177. package/contracts/runbooks/v1/runbook-definition.schema.json +0 -25
  178. package/dist/auth.d.ts +0 -7
  179. package/dist/auth.js +0 -19
  180. package/dist/auth.js.map +0 -1
package/dist/figures.d.ts CHANGED
@@ -19,6 +19,11 @@ export declare const TIMELINE_BLOCK_TYPES: readonly ["stats", "compare", "trend"
19
19
  /** The most JSON one step figure may take, as the backend measures it. */
20
20
  export declare const MAX_STEP_FIGURE_BYTES: number;
21
21
  export type FigurePlacement = "step_figure" | "timeline_block";
22
+ /** Stats a server with figure_extras_v1 takes; the first MAX_STATS_TILES are tiles. */
23
+ export declare const MAX_STATS_ITEMS = 8;
24
+ export declare const MAX_STATS_TILES = 4;
25
+ /** The server takes a stats title, more than 4 stats and runs_not_shown. */
26
+ export declare const FIGURE_EXTRAS_CAPABILITY = "figure_extras_v1";
22
27
  export declare const RUN_RESULTS: readonly ["success", "failure", "cancelled", "pending"];
23
28
  export declare const RUN_MARK_CHANGES: readonly ["regression", "fix", "change"];
24
29
  /** Exported for the step figure schema of tellagen_complete_investigation. */
@@ -30,27 +35,27 @@ export declare const checksBlockSchema: z.ZodObject<{
30
35
  state: z.ZodEnum<["pass", "fail", "pending", "skipped"]>;
31
36
  detail: z.ZodOptional<z.ZodString>;
32
37
  }, "strict", z.ZodTypeAny, {
38
+ state: "pending" | "pass" | "fail" | "skipped";
33
39
  label: string;
34
- state: "pass" | "fail" | "pending" | "skipped";
35
40
  detail?: string | undefined;
36
41
  }, {
42
+ state: "pending" | "pass" | "fail" | "skipped";
37
43
  label: string;
38
- state: "pass" | "fail" | "pending" | "skipped";
39
44
  detail?: string | undefined;
40
45
  }>, "many">;
41
46
  }, "strict", z.ZodTypeAny, {
42
47
  type: "checks";
43
48
  items: {
49
+ state: "pending" | "pass" | "fail" | "skipped";
44
50
  label: string;
45
- state: "pass" | "fail" | "pending" | "skipped";
46
51
  detail?: string | undefined;
47
52
  }[];
48
53
  title?: string | undefined;
49
54
  }, {
50
55
  type: "checks";
51
56
  items: {
57
+ state: "pending" | "pass" | "fail" | "skipped";
52
58
  label: string;
53
- state: "pass" | "fail" | "pending" | "skipped";
54
59
  detail?: string | undefined;
55
60
  }[];
56
61
  title?: string | undefined;
@@ -148,11 +153,6 @@ export declare const histogramBlockSchema: z.ZodObject<{
148
153
  after: number[];
149
154
  edges: number[];
150
155
  title?: string | undefined;
151
- unit?: string | undefined;
152
- threshold?: {
153
- value: number;
154
- label?: string | undefined;
155
- } | undefined;
156
156
  source?: {
157
157
  kind?: string | undefined;
158
158
  datasource?: string | undefined;
@@ -162,17 +162,17 @@ export declare const histogramBlockSchema: z.ZodObject<{
162
162
  step?: string | undefined;
163
163
  artifact_id?: string | undefined;
164
164
  } | undefined;
165
+ unit?: string | undefined;
166
+ threshold?: {
167
+ value: number;
168
+ label?: string | undefined;
169
+ } | undefined;
165
170
  }, {
166
171
  type: "histogram";
167
172
  before: number[];
168
173
  after: number[];
169
174
  edges: number[];
170
175
  title?: string | undefined;
171
- unit?: string | undefined;
172
- threshold?: {
173
- value: number;
174
- label?: string | undefined;
175
- } | undefined;
176
176
  source?: {
177
177
  kind?: string | undefined;
178
178
  datasource?: string | undefined;
@@ -182,6 +182,11 @@ export declare const histogramBlockSchema: z.ZodObject<{
182
182
  step?: string | undefined;
183
183
  artifact_id?: string | undefined;
184
184
  } | undefined;
185
+ unit?: string | undefined;
186
+ threshold?: {
187
+ value: number;
188
+ label?: string | undefined;
189
+ } | undefined;
185
190
  }>;
186
191
  export declare const runHistoryBlockSchema: z.ZodObject<{
187
192
  type: z.ZodLiteral<"run_history">;
@@ -200,19 +205,20 @@ export declare const runHistoryBlockSchema: z.ZodObject<{
200
205
  ref: string;
201
206
  result: "pending" | "success" | "failure" | "cancelled";
202
207
  at?: string | undefined;
208
+ url?: string | undefined;
203
209
  sha?: string | undefined;
204
210
  trigger?: string | undefined;
205
211
  job?: string | undefined;
206
- url?: string | undefined;
207
212
  }, {
208
213
  ref: string;
209
214
  result: "pending" | "success" | "failure" | "cancelled";
210
215
  at?: string | undefined;
216
+ url?: string | undefined;
211
217
  sha?: string | undefined;
212
218
  trigger?: string | undefined;
213
219
  job?: string | undefined;
214
- url?: string | undefined;
215
220
  }>, "many">;
221
+ runs_not_shown: z.ZodOptional<z.ZodNumber>;
216
222
  marks: z.ZodOptional<z.ZodArray<z.ZodObject<{
217
223
  between: z.ZodTuple<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>], null>;
218
224
  change_ref: z.ZodEnum<["regression", "fix", "change"]>;
@@ -221,13 +227,13 @@ export declare const runHistoryBlockSchema: z.ZodObject<{
221
227
  title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
222
228
  }, "strict", z.ZodTypeAny, {
223
229
  between: [string, string];
224
- change_ref: "regression" | "fix" | "change";
230
+ change_ref: "fix" | "change" | "regression";
225
231
  at?: string | undefined;
226
232
  title?: string | undefined;
227
233
  sha?: string | undefined;
228
234
  }, {
229
235
  between: [string, string];
230
- change_ref: "regression" | "fix" | "change";
236
+ change_ref: "fix" | "change" | "regression";
231
237
  at?: string | undefined;
232
238
  title?: string | undefined;
233
239
  sha?: string | undefined;
@@ -251,21 +257,22 @@ export declare const runHistoryBlockSchema: z.ZodObject<{
251
257
  ref: string;
252
258
  result: "pending" | "success" | "failure" | "cancelled";
253
259
  at?: string | undefined;
260
+ url?: string | undefined;
254
261
  sha?: string | undefined;
255
262
  trigger?: string | undefined;
256
263
  job?: string | undefined;
257
- url?: string | undefined;
258
264
  }[];
259
265
  title?: string | undefined;
260
266
  marks?: {
261
267
  between: [string, string];
262
- change_ref: "regression" | "fix" | "change";
268
+ change_ref: "fix" | "change" | "regression";
263
269
  at?: string | undefined;
264
270
  title?: string | undefined;
265
271
  sha?: string | undefined;
266
272
  }[] | undefined;
267
273
  repo?: string | undefined;
268
274
  branch?: string | undefined;
275
+ runs_not_shown?: number | undefined;
269
276
  span?: {
270
277
  label: string;
271
278
  from: string;
@@ -277,21 +284,22 @@ export declare const runHistoryBlockSchema: z.ZodObject<{
277
284
  ref: string;
278
285
  result: "pending" | "success" | "failure" | "cancelled";
279
286
  at?: string | undefined;
287
+ url?: string | undefined;
280
288
  sha?: string | undefined;
281
289
  trigger?: string | undefined;
282
290
  job?: string | undefined;
283
- url?: string | undefined;
284
291
  }[];
285
292
  title?: string | undefined;
286
293
  marks?: {
287
294
  between: [string, string];
288
- change_ref: "regression" | "fix" | "change";
295
+ change_ref: "fix" | "change" | "regression";
289
296
  at?: string | undefined;
290
297
  title?: string | undefined;
291
298
  sha?: string | undefined;
292
299
  }[] | undefined;
293
300
  repo?: string | undefined;
294
301
  branch?: string | undefined;
302
+ runs_not_shown?: number | undefined;
295
303
  span?: {
296
304
  label: string;
297
305
  from: string;
@@ -308,38 +316,48 @@ export declare const diffBlockSchema: z.ZodObject<{
308
316
  additions: z.ZodNumber;
309
317
  deletions: z.ZodNumber;
310
318
  hunks: z.ZodArray<z.ZodArray<z.ZodObject<{
311
- op: z.ZodEnum<["+", "-"]>;
319
+ op: z.ZodEnum<["+", "-", "context"]>;
312
320
  text: z.ZodEffects<z.ZodString, string, string>;
321
+ old_no: z.ZodOptional<z.ZodNumber>;
322
+ new_no: z.ZodOptional<z.ZodNumber>;
313
323
  }, "strict", z.ZodTypeAny, {
314
- op: "+" | "-";
315
324
  text: string;
325
+ op: "-" | "context" | "+";
326
+ old_no?: number | undefined;
327
+ new_no?: number | undefined;
316
328
  }, {
317
- op: "+" | "-";
318
329
  text: string;
330
+ op: "-" | "context" | "+";
331
+ old_no?: number | undefined;
332
+ new_no?: number | undefined;
319
333
  }>, "many">, "many">;
320
334
  }, "strict", z.ZodTypeAny, {
321
335
  path: string;
322
336
  type: "diff";
323
- ref: string;
324
- additions: number;
325
- deletions: number;
326
337
  hunks: {
327
- op: "+" | "-";
328
338
  text: string;
339
+ op: "-" | "context" | "+";
340
+ old_no?: number | undefined;
341
+ new_no?: number | undefined;
329
342
  }[][];
343
+ ref: string;
344
+ additions: number;
345
+ deletions: number;
330
346
  at?: string | undefined;
331
347
  title?: string | undefined;
332
348
  repo?: string | undefined;
333
349
  }, {
334
350
  path: string;
335
351
  type: "diff";
336
- ref: string;
337
- additions: number;
338
- deletions: number;
339
352
  hunks: {
340
- op: "+" | "-";
341
353
  text: string;
354
+ op: "-" | "context" | "+";
355
+ old_no?: number | undefined;
356
+ new_no?: number | undefined;
342
357
  }[][];
358
+ ref: string;
359
+ additions: number;
360
+ deletions: number;
343
361
  at?: string | undefined;
344
362
  title?: string | undefined;
345
363
  repo?: string | undefined;
@@ -362,6 +380,7 @@ export declare function figureRuleIssues(block: {
362
380
  */
363
381
  export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
364
382
  type: z.ZodLiteral<"stats">;
383
+ title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
365
384
  items: z.ZodArray<z.ZodObject<{
366
385
  label: z.ZodString;
367
386
  value: z.ZodString;
@@ -390,9 +409,10 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
390
409
  caption?: string | undefined;
391
410
  tone?: "good" | "warn" | "bad" | "neutral" | undefined;
392
411
  }[];
393
- slot?: "summary" | undefined;
412
+ title?: string | undefined;
394
413
  anchor?: string | undefined;
395
414
  postmortem?: boolean | undefined;
415
+ slot?: "summary" | undefined;
396
416
  }, {
397
417
  type: "stats";
398
418
  items: {
@@ -401,9 +421,10 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
401
421
  caption?: string | undefined;
402
422
  tone?: "good" | "warn" | "bad" | "neutral" | undefined;
403
423
  }[];
404
- slot?: "summary" | undefined;
424
+ title?: string | undefined;
405
425
  anchor?: string | undefined;
406
426
  postmortem?: boolean | undefined;
427
+ slot?: "summary" | undefined;
407
428
  }>, z.ZodObject<{
408
429
  type: z.ZodLiteral<"compare">;
409
430
  title: z.ZodOptional<z.ZodString>;
@@ -444,22 +465,22 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
444
465
  label: string;
445
466
  before: number;
446
467
  after: number;
447
- mono?: boolean | undefined;
448
468
  details?: {
449
469
  label: string;
450
470
  before: string;
451
471
  after: string;
452
472
  }[] | undefined;
473
+ mono?: boolean | undefined;
453
474
  }, {
454
475
  label: string;
455
476
  before: number;
456
477
  after: number;
457
- mono?: boolean | undefined;
458
478
  details?: {
459
479
  label: string;
460
480
  before: string;
461
481
  after: string;
462
482
  }[] | undefined;
483
+ mono?: boolean | undefined;
463
484
  }>, "many">;
464
485
  } & {
465
486
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
@@ -471,14 +492,16 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
471
492
  label: string;
472
493
  before: number;
473
494
  after: number;
474
- mono?: boolean | undefined;
475
495
  details?: {
476
496
  label: string;
477
497
  before: string;
478
498
  after: string;
479
499
  }[] | undefined;
500
+ mono?: boolean | undefined;
480
501
  }[];
481
502
  title?: string | undefined;
503
+ anchor?: string | undefined;
504
+ postmortem?: boolean | undefined;
482
505
  metric?: string | undefined;
483
506
  unit?: string | undefined;
484
507
  better?: "lower" | "higher" | undefined;
@@ -489,22 +512,22 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
489
512
  label?: string | undefined;
490
513
  } | undefined;
491
514
  slot?: "summary" | undefined;
492
- anchor?: string | undefined;
493
- postmortem?: boolean | undefined;
494
515
  }, {
495
516
  type: "compare";
496
517
  rows: {
497
518
  label: string;
498
519
  before: number;
499
520
  after: number;
500
- mono?: boolean | undefined;
501
521
  details?: {
502
522
  label: string;
503
523
  before: string;
504
524
  after: string;
505
525
  }[] | undefined;
526
+ mono?: boolean | undefined;
506
527
  }[];
507
528
  title?: string | undefined;
529
+ anchor?: string | undefined;
530
+ postmortem?: boolean | undefined;
508
531
  metric?: string | undefined;
509
532
  unit?: string | undefined;
510
533
  better?: "lower" | "higher" | undefined;
@@ -515,8 +538,6 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
515
538
  label?: string | undefined;
516
539
  } | undefined;
517
540
  slot?: "summary" | undefined;
518
- anchor?: string | undefined;
519
- postmortem?: boolean | undefined;
520
541
  }>, z.ZodObject<{
521
542
  type: z.ZodLiteral<"trend">;
522
543
  title: z.ZodOptional<z.ZodString>;
@@ -578,6 +599,17 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
578
599
  type: "trend";
579
600
  series: number[];
580
601
  title?: string | undefined;
602
+ anchor?: string | undefined;
603
+ source?: {
604
+ kind?: string | undefined;
605
+ datasource?: string | undefined;
606
+ query?: string | undefined;
607
+ from?: string | undefined;
608
+ to?: string | undefined;
609
+ step?: string | undefined;
610
+ artifact_id?: string | undefined;
611
+ } | undefined;
612
+ postmortem?: boolean | undefined;
581
613
  unit?: string | undefined;
582
614
  max?: number | undefined;
583
615
  threshold?: {
@@ -590,6 +622,12 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
590
622
  label: string;
591
623
  i: number;
592
624
  }[] | undefined;
625
+ slot?: "summary" | undefined;
626
+ }, {
627
+ type: "trend";
628
+ series: number[];
629
+ title?: string | undefined;
630
+ anchor?: string | undefined;
593
631
  source?: {
594
632
  kind?: string | undefined;
595
633
  datasource?: string | undefined;
@@ -599,13 +637,7 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
599
637
  step?: string | undefined;
600
638
  artifact_id?: string | undefined;
601
639
  } | undefined;
602
- slot?: "summary" | undefined;
603
- anchor?: string | undefined;
604
640
  postmortem?: boolean | undefined;
605
- }, {
606
- type: "trend";
607
- series: number[];
608
- title?: string | undefined;
609
641
  unit?: string | undefined;
610
642
  max?: number | undefined;
611
643
  threshold?: {
@@ -618,18 +650,7 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
618
650
  label: string;
619
651
  i: number;
620
652
  }[] | undefined;
621
- source?: {
622
- kind?: string | undefined;
623
- datasource?: string | undefined;
624
- query?: string | undefined;
625
- from?: string | undefined;
626
- to?: string | undefined;
627
- step?: string | undefined;
628
- artifact_id?: string | undefined;
629
- } | undefined;
630
653
  slot?: "summary" | undefined;
631
- anchor?: string | undefined;
632
- postmortem?: boolean | undefined;
633
654
  }>, z.ZodObject<{
634
655
  type: z.ZodLiteral<"table">;
635
656
  title: z.ZodOptional<z.ZodString>;
@@ -660,9 +681,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
660
681
  label: string;
661
682
  }[];
662
683
  title?: string | undefined;
663
- slot?: "summary" | undefined;
664
684
  anchor?: string | undefined;
665
685
  postmortem?: boolean | undefined;
686
+ slot?: "summary" | undefined;
666
687
  }, {
667
688
  type: "table";
668
689
  rows: {
@@ -672,9 +693,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
672
693
  label: string;
673
694
  }[];
674
695
  title?: string | undefined;
675
- slot?: "summary" | undefined;
676
696
  anchor?: string | undefined;
677
697
  postmortem?: boolean | undefined;
698
+ slot?: "summary" | undefined;
678
699
  }>, z.ZodObject<{
679
700
  type: z.ZodLiteral<"checks">;
680
701
  title: z.ZodOptional<z.ZodString>;
@@ -683,12 +704,12 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
683
704
  state: z.ZodEnum<["pass", "fail", "pending", "skipped"]>;
684
705
  detail: z.ZodOptional<z.ZodString>;
685
706
  }, "strict", z.ZodTypeAny, {
707
+ state: "pending" | "pass" | "fail" | "skipped";
686
708
  label: string;
687
- state: "pass" | "fail" | "pending" | "skipped";
688
709
  detail?: string | undefined;
689
710
  }, {
711
+ state: "pending" | "pass" | "fail" | "skipped";
690
712
  label: string;
691
- state: "pass" | "fail" | "pending" | "skipped";
692
713
  detail?: string | undefined;
693
714
  }>, "many">;
694
715
  } & {
@@ -698,25 +719,25 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
698
719
  }, "strict", z.ZodTypeAny, {
699
720
  type: "checks";
700
721
  items: {
722
+ state: "pending" | "pass" | "fail" | "skipped";
701
723
  label: string;
702
- state: "pass" | "fail" | "pending" | "skipped";
703
724
  detail?: string | undefined;
704
725
  }[];
705
726
  title?: string | undefined;
706
- slot?: "summary" | undefined;
707
727
  anchor?: string | undefined;
708
728
  postmortem?: boolean | undefined;
729
+ slot?: "summary" | undefined;
709
730
  }, {
710
731
  type: "checks";
711
732
  items: {
733
+ state: "pending" | "pass" | "fail" | "skipped";
712
734
  label: string;
713
- state: "pass" | "fail" | "pending" | "skipped";
714
735
  detail?: string | undefined;
715
736
  }[];
716
737
  title?: string | undefined;
717
- slot?: "summary" | undefined;
718
738
  anchor?: string | undefined;
719
739
  postmortem?: boolean | undefined;
740
+ slot?: "summary" | undefined;
720
741
  }>, z.ZodObject<{
721
742
  type: z.ZodLiteral<"changes">;
722
743
  title: z.ZodOptional<z.ZodString>;
@@ -749,9 +770,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
749
770
  note?: string | undefined;
750
771
  }[];
751
772
  title?: string | undefined;
752
- slot?: "summary" | undefined;
753
773
  anchor?: string | undefined;
754
774
  postmortem?: boolean | undefined;
775
+ slot?: "summary" | undefined;
755
776
  }, {
756
777
  type: "changes";
757
778
  rows: {
@@ -761,9 +782,9 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
761
782
  note?: string | undefined;
762
783
  }[];
763
784
  title?: string | undefined;
764
- slot?: "summary" | undefined;
765
785
  anchor?: string | undefined;
766
786
  postmortem?: boolean | undefined;
787
+ slot?: "summary" | undefined;
767
788
  }>, z.ZodObject<{
768
789
  type: z.ZodLiteral<"range_overlap">;
769
790
  title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -796,13 +817,13 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
796
817
  to: number;
797
818
  }[];
798
819
  title?: string | undefined;
820
+ anchor?: string | undefined;
821
+ postmortem?: boolean | undefined;
799
822
  unit?: string | undefined;
800
823
  max?: number | undefined;
801
824
  min?: number | undefined;
802
825
  window?: [number, number] | undefined;
803
826
  slot?: "summary" | undefined;
804
- anchor?: string | undefined;
805
- postmortem?: boolean | undefined;
806
827
  }, {
807
828
  type: "range_overlap";
808
829
  rows: {
@@ -811,13 +832,13 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
811
832
  to: number;
812
833
  }[];
813
834
  title?: string | undefined;
835
+ anchor?: string | undefined;
836
+ postmortem?: boolean | undefined;
814
837
  unit?: string | undefined;
815
838
  max?: number | undefined;
816
839
  min?: number | undefined;
817
840
  window?: [number, number] | undefined;
818
841
  slot?: "summary" | undefined;
819
- anchor?: string | undefined;
820
- postmortem?: boolean | undefined;
821
842
  }>, z.ZodObject<{
822
843
  type: z.ZodLiteral<"histogram">;
823
844
  title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -870,11 +891,7 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
870
891
  after: number[];
871
892
  edges: number[];
872
893
  title?: string | undefined;
873
- unit?: string | undefined;
874
- threshold?: {
875
- value: number;
876
- label?: string | undefined;
877
- } | undefined;
894
+ anchor?: string | undefined;
878
895
  source?: {
879
896
  kind?: string | undefined;
880
897
  datasource?: string | undefined;
@@ -884,20 +901,20 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
884
901
  step?: string | undefined;
885
902
  artifact_id?: string | undefined;
886
903
  } | undefined;
887
- slot?: "summary" | undefined;
888
- anchor?: string | undefined;
889
904
  postmortem?: boolean | undefined;
905
+ unit?: string | undefined;
906
+ threshold?: {
907
+ value: number;
908
+ label?: string | undefined;
909
+ } | undefined;
910
+ slot?: "summary" | undefined;
890
911
  }, {
891
912
  type: "histogram";
892
913
  before: number[];
893
914
  after: number[];
894
915
  edges: number[];
895
916
  title?: string | undefined;
896
- unit?: string | undefined;
897
- threshold?: {
898
- value: number;
899
- label?: string | undefined;
900
- } | undefined;
917
+ anchor?: string | undefined;
901
918
  source?: {
902
919
  kind?: string | undefined;
903
920
  datasource?: string | undefined;
@@ -907,9 +924,13 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
907
924
  step?: string | undefined;
908
925
  artifact_id?: string | undefined;
909
926
  } | undefined;
910
- slot?: "summary" | undefined;
911
- anchor?: string | undefined;
912
927
  postmortem?: boolean | undefined;
928
+ unit?: string | undefined;
929
+ threshold?: {
930
+ value: number;
931
+ label?: string | undefined;
932
+ } | undefined;
933
+ slot?: "summary" | undefined;
913
934
  }>, z.ZodObject<{
914
935
  type: z.ZodLiteral<"run_history">;
915
936
  title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -927,19 +948,20 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
927
948
  ref: string;
928
949
  result: "pending" | "success" | "failure" | "cancelled";
929
950
  at?: string | undefined;
951
+ url?: string | undefined;
930
952
  sha?: string | undefined;
931
953
  trigger?: string | undefined;
932
954
  job?: string | undefined;
933
- url?: string | undefined;
934
955
  }, {
935
956
  ref: string;
936
957
  result: "pending" | "success" | "failure" | "cancelled";
937
958
  at?: string | undefined;
959
+ url?: string | undefined;
938
960
  sha?: string | undefined;
939
961
  trigger?: string | undefined;
940
962
  job?: string | undefined;
941
- url?: string | undefined;
942
963
  }>, "many">;
964
+ runs_not_shown: z.ZodOptional<z.ZodNumber>;
943
965
  marks: z.ZodOptional<z.ZodArray<z.ZodObject<{
944
966
  between: z.ZodTuple<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>], null>;
945
967
  change_ref: z.ZodEnum<["regression", "fix", "change"]>;
@@ -948,13 +970,13 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
948
970
  title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
949
971
  }, "strict", z.ZodTypeAny, {
950
972
  between: [string, string];
951
- change_ref: "regression" | "fix" | "change";
973
+ change_ref: "fix" | "change" | "regression";
952
974
  at?: string | undefined;
953
975
  title?: string | undefined;
954
976
  sha?: string | undefined;
955
977
  }, {
956
978
  between: [string, string];
957
- change_ref: "regression" | "fix" | "change";
979
+ change_ref: "fix" | "change" | "regression";
958
980
  at?: string | undefined;
959
981
  title?: string | undefined;
960
982
  sha?: string | undefined;
@@ -982,58 +1004,60 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
982
1004
  ref: string;
983
1005
  result: "pending" | "success" | "failure" | "cancelled";
984
1006
  at?: string | undefined;
1007
+ url?: string | undefined;
985
1008
  sha?: string | undefined;
986
1009
  trigger?: string | undefined;
987
1010
  job?: string | undefined;
988
- url?: string | undefined;
989
1011
  }[];
990
1012
  title?: string | undefined;
1013
+ anchor?: string | undefined;
1014
+ postmortem?: boolean | undefined;
991
1015
  marks?: {
992
1016
  between: [string, string];
993
- change_ref: "regression" | "fix" | "change";
1017
+ change_ref: "fix" | "change" | "regression";
994
1018
  at?: string | undefined;
995
1019
  title?: string | undefined;
996
1020
  sha?: string | undefined;
997
1021
  }[] | undefined;
998
1022
  repo?: string | undefined;
999
1023
  branch?: string | undefined;
1024
+ runs_not_shown?: number | undefined;
1000
1025
  span?: {
1001
1026
  label: string;
1002
1027
  from: string;
1003
1028
  to: string;
1004
1029
  } | undefined;
1005
1030
  slot?: "summary" | undefined;
1006
- anchor?: string | undefined;
1007
- postmortem?: boolean | undefined;
1008
1031
  }, {
1009
1032
  type: "run_history";
1010
1033
  runs: {
1011
1034
  ref: string;
1012
1035
  result: "pending" | "success" | "failure" | "cancelled";
1013
1036
  at?: string | undefined;
1037
+ url?: string | undefined;
1014
1038
  sha?: string | undefined;
1015
1039
  trigger?: string | undefined;
1016
1040
  job?: string | undefined;
1017
- url?: string | undefined;
1018
1041
  }[];
1019
1042
  title?: string | undefined;
1043
+ anchor?: string | undefined;
1044
+ postmortem?: boolean | undefined;
1020
1045
  marks?: {
1021
1046
  between: [string, string];
1022
- change_ref: "regression" | "fix" | "change";
1047
+ change_ref: "fix" | "change" | "regression";
1023
1048
  at?: string | undefined;
1024
1049
  title?: string | undefined;
1025
1050
  sha?: string | undefined;
1026
1051
  }[] | undefined;
1027
1052
  repo?: string | undefined;
1028
1053
  branch?: string | undefined;
1054
+ runs_not_shown?: number | undefined;
1029
1055
  span?: {
1030
1056
  label: string;
1031
1057
  from: string;
1032
1058
  to: string;
1033
1059
  } | undefined;
1034
1060
  slot?: "summary" | undefined;
1035
- anchor?: string | undefined;
1036
- postmortem?: boolean | undefined;
1037
1061
  }>, z.ZodObject<{
1038
1062
  type: z.ZodLiteral<"diff">;
1039
1063
  title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -1044,14 +1068,20 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
1044
1068
  additions: z.ZodNumber;
1045
1069
  deletions: z.ZodNumber;
1046
1070
  hunks: z.ZodArray<z.ZodArray<z.ZodObject<{
1047
- op: z.ZodEnum<["+", "-"]>;
1071
+ op: z.ZodEnum<["+", "-", "context"]>;
1048
1072
  text: z.ZodEffects<z.ZodString, string, string>;
1073
+ old_no: z.ZodOptional<z.ZodNumber>;
1074
+ new_no: z.ZodOptional<z.ZodNumber>;
1049
1075
  }, "strict", z.ZodTypeAny, {
1050
- op: "+" | "-";
1051
1076
  text: string;
1077
+ op: "-" | "context" | "+";
1078
+ old_no?: number | undefined;
1079
+ new_no?: number | undefined;
1052
1080
  }, {
1053
- op: "+" | "-";
1054
1081
  text: string;
1082
+ op: "-" | "context" | "+";
1083
+ old_no?: number | undefined;
1084
+ new_no?: number | undefined;
1055
1085
  }>, "many">, "many">;
1056
1086
  } & {
1057
1087
  slot: z.ZodOptional<z.ZodLiteral<"summary">>;
@@ -1060,35 +1090,39 @@ export declare const timelineBlockSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
1060
1090
  }, "strict", z.ZodTypeAny, {
1061
1091
  path: string;
1062
1092
  type: "diff";
1063
- ref: string;
1064
- additions: number;
1065
- deletions: number;
1066
1093
  hunks: {
1067
- op: "+" | "-";
1068
1094
  text: string;
1095
+ op: "-" | "context" | "+";
1096
+ old_no?: number | undefined;
1097
+ new_no?: number | undefined;
1069
1098
  }[][];
1099
+ ref: string;
1100
+ additions: number;
1101
+ deletions: number;
1070
1102
  at?: string | undefined;
1071
1103
  title?: string | undefined;
1072
- repo?: string | undefined;
1073
- slot?: "summary" | undefined;
1074
1104
  anchor?: string | undefined;
1075
1105
  postmortem?: boolean | undefined;
1106
+ repo?: string | undefined;
1107
+ slot?: "summary" | undefined;
1076
1108
  }, {
1077
1109
  path: string;
1078
1110
  type: "diff";
1079
- ref: string;
1080
- additions: number;
1081
- deletions: number;
1082
1111
  hunks: {
1083
- op: "+" | "-";
1084
1112
  text: string;
1113
+ op: "-" | "context" | "+";
1114
+ old_no?: number | undefined;
1115
+ new_no?: number | undefined;
1085
1116
  }[][];
1117
+ ref: string;
1118
+ additions: number;
1119
+ deletions: number;
1086
1120
  at?: string | undefined;
1087
1121
  title?: string | undefined;
1088
- repo?: string | undefined;
1089
- slot?: "summary" | undefined;
1090
1122
  anchor?: string | undefined;
1091
1123
  postmortem?: boolean | undefined;
1124
+ repo?: string | undefined;
1125
+ slot?: "summary" | undefined;
1092
1126
  }>]>;
1093
1127
  /**
1094
1128
  * The light check the timeline tools apply to `blocks`. The full schema above
@@ -1106,6 +1140,7 @@ export declare const timelineBlockRefSchema: z.ZodObject<{
1106
1140
  /** What tellagen_build_figure accepts. */
1107
1141
  export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
1108
1142
  type: z.ZodLiteral<"stats">;
1143
+ title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1109
1144
  items: z.ZodArray<z.ZodObject<{
1110
1145
  label: z.ZodString;
1111
1146
  value: z.ZodString;
@@ -1130,6 +1165,7 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1130
1165
  caption?: string | undefined;
1131
1166
  tone?: "good" | "warn" | "bad" | "neutral" | undefined;
1132
1167
  }[];
1168
+ title?: string | undefined;
1133
1169
  }, {
1134
1170
  type: "stats";
1135
1171
  items: {
@@ -1138,6 +1174,7 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1138
1174
  caption?: string | undefined;
1139
1175
  tone?: "good" | "warn" | "bad" | "neutral" | undefined;
1140
1176
  }[];
1177
+ title?: string | undefined;
1141
1178
  }>, z.ZodObject<{
1142
1179
  type: z.ZodLiteral<"compare">;
1143
1180
  title: z.ZodOptional<z.ZodString>;
@@ -1178,22 +1215,22 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1178
1215
  label: string;
1179
1216
  before: number;
1180
1217
  after: number;
1181
- mono?: boolean | undefined;
1182
1218
  details?: {
1183
1219
  label: string;
1184
1220
  before: string;
1185
1221
  after: string;
1186
1222
  }[] | undefined;
1223
+ mono?: boolean | undefined;
1187
1224
  }, {
1188
1225
  label: string;
1189
1226
  before: number;
1190
1227
  after: number;
1191
- mono?: boolean | undefined;
1192
1228
  details?: {
1193
1229
  label: string;
1194
1230
  before: string;
1195
1231
  after: string;
1196
1232
  }[] | undefined;
1233
+ mono?: boolean | undefined;
1197
1234
  }>, "many">;
1198
1235
  }, "strict", z.ZodTypeAny, {
1199
1236
  type: "compare";
@@ -1201,12 +1238,12 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1201
1238
  label: string;
1202
1239
  before: number;
1203
1240
  after: number;
1204
- mono?: boolean | undefined;
1205
1241
  details?: {
1206
1242
  label: string;
1207
1243
  before: string;
1208
1244
  after: string;
1209
1245
  }[] | undefined;
1246
+ mono?: boolean | undefined;
1210
1247
  }[];
1211
1248
  title?: string | undefined;
1212
1249
  metric?: string | undefined;
@@ -1224,12 +1261,12 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1224
1261
  label: string;
1225
1262
  before: number;
1226
1263
  after: number;
1227
- mono?: boolean | undefined;
1228
1264
  details?: {
1229
1265
  label: string;
1230
1266
  before: string;
1231
1267
  after: string;
1232
1268
  }[] | undefined;
1269
+ mono?: boolean | undefined;
1233
1270
  }[];
1234
1271
  title?: string | undefined;
1235
1272
  metric?: string | undefined;
@@ -1262,11 +1299,11 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1262
1299
  at: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
1263
1300
  label: z.ZodString;
1264
1301
  }, "strict", z.ZodTypeAny, {
1265
- label: string;
1266
1302
  at: string | number;
1267
- }, {
1268
1303
  label: string;
1304
+ }, {
1269
1305
  at: string | number;
1306
+ label: string;
1270
1307
  }>, "many">>;
1271
1308
  marks: z.ZodOptional<z.ZodArray<z.ZodObject<{
1272
1309
  i: z.ZodNumber;
@@ -1321,6 +1358,15 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1321
1358
  type: "trend";
1322
1359
  reduce?: "max" | "min" | "mean" | "last" | undefined;
1323
1360
  title?: string | undefined;
1361
+ source?: {
1362
+ kind?: string | undefined;
1363
+ datasource?: string | undefined;
1364
+ query?: string | undefined;
1365
+ from?: string | undefined;
1366
+ to?: string | undefined;
1367
+ step?: string | undefined;
1368
+ artifact_id?: string | undefined;
1369
+ } | undefined;
1324
1370
  unit?: string | undefined;
1325
1371
  max?: number | undefined;
1326
1372
  threshold?: {
@@ -1334,22 +1380,13 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1334
1380
  label: string;
1335
1381
  i: number;
1336
1382
  }[] | undefined;
1337
- source?: {
1338
- kind?: string | undefined;
1339
- datasource?: string | undefined;
1340
- query?: string | undefined;
1341
- from?: string | undefined;
1342
- to?: string | undefined;
1343
- step?: string | undefined;
1344
- artifact_id?: string | undefined;
1345
- } | undefined;
1346
1383
  points?: {
1347
1384
  t: string | number;
1348
1385
  v: string | number | null;
1349
1386
  }[] | undefined;
1350
1387
  events?: {
1351
- label: string;
1352
1388
  at: string | number;
1389
+ label: string;
1353
1390
  }[] | undefined;
1354
1391
  max_points?: number | undefined;
1355
1392
  precision?: number | undefined;
@@ -1357,6 +1394,15 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1357
1394
  type: "trend";
1358
1395
  reduce?: "max" | "min" | "mean" | "last" | undefined;
1359
1396
  title?: string | undefined;
1397
+ source?: {
1398
+ kind?: string | undefined;
1399
+ datasource?: string | undefined;
1400
+ query?: string | undefined;
1401
+ from?: string | undefined;
1402
+ to?: string | undefined;
1403
+ step?: string | undefined;
1404
+ artifact_id?: string | undefined;
1405
+ } | undefined;
1360
1406
  unit?: string | undefined;
1361
1407
  max?: number | undefined;
1362
1408
  threshold?: {
@@ -1370,22 +1416,13 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1370
1416
  label: string;
1371
1417
  i: number;
1372
1418
  }[] | undefined;
1373
- source?: {
1374
- kind?: string | undefined;
1375
- datasource?: string | undefined;
1376
- query?: string | undefined;
1377
- from?: string | undefined;
1378
- to?: string | undefined;
1379
- step?: string | undefined;
1380
- artifact_id?: string | undefined;
1381
- } | undefined;
1382
1419
  points?: {
1383
1420
  t: string | number;
1384
1421
  v: string | number | null;
1385
1422
  }[] | undefined;
1386
1423
  events?: {
1387
- label: string;
1388
1424
  at: string | number;
1425
+ label: string;
1389
1426
  }[] | undefined;
1390
1427
  max_points?: number | undefined;
1391
1428
  precision?: number | undefined;
@@ -1432,27 +1469,27 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1432
1469
  state: z.ZodEnum<["pass", "fail", "pending", "skipped"]>;
1433
1470
  detail: z.ZodOptional<z.ZodString>;
1434
1471
  }, "strict", z.ZodTypeAny, {
1472
+ state: "pending" | "pass" | "fail" | "skipped";
1435
1473
  label: string;
1436
- state: "pass" | "fail" | "pending" | "skipped";
1437
1474
  detail?: string | undefined;
1438
1475
  }, {
1476
+ state: "pending" | "pass" | "fail" | "skipped";
1439
1477
  label: string;
1440
- state: "pass" | "fail" | "pending" | "skipped";
1441
1478
  detail?: string | undefined;
1442
1479
  }>, "many">;
1443
1480
  }, "strict", z.ZodTypeAny, {
1444
1481
  type: "checks";
1445
1482
  items: {
1483
+ state: "pending" | "pass" | "fail" | "skipped";
1446
1484
  label: string;
1447
- state: "pass" | "fail" | "pending" | "skipped";
1448
1485
  detail?: string | undefined;
1449
1486
  }[];
1450
1487
  title?: string | undefined;
1451
1488
  }, {
1452
1489
  type: "checks";
1453
1490
  items: {
1491
+ state: "pending" | "pass" | "fail" | "skipped";
1454
1492
  label: string;
1455
- state: "pass" | "fail" | "pending" | "skipped";
1456
1493
  detail?: string | undefined;
1457
1494
  }[];
1458
1495
  title?: string | undefined;
@@ -1597,13 +1634,6 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1597
1634
  }, "strict", z.ZodTypeAny, {
1598
1635
  type: "histogram";
1599
1636
  title?: string | undefined;
1600
- unit?: string | undefined;
1601
- threshold?: {
1602
- value: number;
1603
- label?: string | undefined;
1604
- } | undefined;
1605
- before?: number[] | undefined;
1606
- after?: number[] | undefined;
1607
1637
  source?: {
1608
1638
  kind?: string | undefined;
1609
1639
  datasource?: string | undefined;
@@ -1613,6 +1643,13 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1613
1643
  step?: string | undefined;
1614
1644
  artifact_id?: string | undefined;
1615
1645
  } | undefined;
1646
+ unit?: string | undefined;
1647
+ threshold?: {
1648
+ value: number;
1649
+ label?: string | undefined;
1650
+ } | undefined;
1651
+ before?: number[] | undefined;
1652
+ after?: number[] | undefined;
1616
1653
  edges?: number[] | undefined;
1617
1654
  buckets?: {
1618
1655
  before: string | number;
@@ -1624,13 +1661,6 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1624
1661
  }, {
1625
1662
  type: "histogram";
1626
1663
  title?: string | undefined;
1627
- unit?: string | undefined;
1628
- threshold?: {
1629
- value: number;
1630
- label?: string | undefined;
1631
- } | undefined;
1632
- before?: number[] | undefined;
1633
- after?: number[] | undefined;
1634
1664
  source?: {
1635
1665
  kind?: string | undefined;
1636
1666
  datasource?: string | undefined;
@@ -1640,6 +1670,13 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1640
1670
  step?: string | undefined;
1641
1671
  artifact_id?: string | undefined;
1642
1672
  } | undefined;
1673
+ unit?: string | undefined;
1674
+ threshold?: {
1675
+ value: number;
1676
+ label?: string | undefined;
1677
+ } | undefined;
1678
+ before?: number[] | undefined;
1679
+ after?: number[] | undefined;
1643
1680
  edges?: number[] | undefined;
1644
1681
  buckets?: {
1645
1682
  before: string | number;
@@ -1665,18 +1702,18 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1665
1702
  ref: string;
1666
1703
  result: "pending" | "success" | "failure" | "cancelled";
1667
1704
  at?: string | undefined;
1705
+ url?: string | undefined;
1668
1706
  sha?: string | undefined;
1669
1707
  trigger?: string | undefined;
1670
1708
  job?: string | undefined;
1671
- url?: string | undefined;
1672
1709
  }, {
1673
1710
  ref: string;
1674
1711
  result: "pending" | "success" | "failure" | "cancelled";
1675
1712
  at?: string | undefined;
1713
+ url?: string | undefined;
1676
1714
  sha?: string | undefined;
1677
1715
  trigger?: string | undefined;
1678
1716
  job?: string | undefined;
1679
- url?: string | undefined;
1680
1717
  }>, "many">>;
1681
1718
  github_runs: z.ZodOptional<z.ZodArray<z.ZodObject<{
1682
1719
  id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
@@ -1730,6 +1767,7 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1730
1767
  url: z.ZodOptional<z.ZodString>;
1731
1768
  job: z.ZodOptional<z.ZodString>;
1732
1769
  }, z.ZodTypeAny, "passthrough">>, "many">>;
1770
+ runs_not_shown: z.ZodOptional<z.ZodNumber>;
1733
1771
  marks: z.ZodOptional<z.ZodArray<z.ZodObject<{
1734
1772
  between: z.ZodOptional<z.ZodTuple<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>], null>>;
1735
1773
  sha: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -1778,11 +1816,12 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1778
1816
  ref: string;
1779
1817
  result: "pending" | "success" | "failure" | "cancelled";
1780
1818
  at?: string | undefined;
1819
+ url?: string | undefined;
1781
1820
  sha?: string | undefined;
1782
1821
  trigger?: string | undefined;
1783
1822
  job?: string | undefined;
1784
- url?: string | undefined;
1785
1823
  }[] | undefined;
1824
+ runs_not_shown?: number | undefined;
1786
1825
  span?: {
1787
1826
  label: string;
1788
1827
  from: string;
@@ -1822,11 +1861,12 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1822
1861
  ref: string;
1823
1862
  result: "pending" | "success" | "failure" | "cancelled";
1824
1863
  at?: string | undefined;
1864
+ url?: string | undefined;
1825
1865
  sha?: string | undefined;
1826
1866
  trigger?: string | undefined;
1827
1867
  job?: string | undefined;
1828
- url?: string | undefined;
1829
1868
  }[] | undefined;
1869
+ runs_not_shown?: number | undefined;
1830
1870
  span?: {
1831
1871
  label: string;
1832
1872
  from: string;
@@ -1860,16 +1900,23 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1860
1900
  additions: z.ZodNumber;
1861
1901
  deletions: z.ZodNumber;
1862
1902
  hunks: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodObject<{
1863
- op: z.ZodEnum<["+", "-"]>;
1903
+ op: z.ZodEnum<["+", "-", "context"]>;
1864
1904
  text: z.ZodEffects<z.ZodString, string, string>;
1905
+ old_no: z.ZodOptional<z.ZodNumber>;
1906
+ new_no: z.ZodOptional<z.ZodNumber>;
1865
1907
  }, "strict", z.ZodTypeAny, {
1866
- op: "+" | "-";
1867
1908
  text: string;
1909
+ op: "-" | "context" | "+";
1910
+ old_no?: number | undefined;
1911
+ new_no?: number | undefined;
1868
1912
  }, {
1869
- op: "+" | "-";
1870
1913
  text: string;
1914
+ op: "-" | "context" | "+";
1915
+ old_no?: number | undefined;
1916
+ new_no?: number | undefined;
1871
1917
  }>, "many">, "many">>;
1872
1918
  patch: z.ZodOptional<z.ZodString>;
1919
+ select_hunks: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
1873
1920
  }, "strict", z.ZodTypeAny, {
1874
1921
  path: string;
1875
1922
  type: "diff";
@@ -1878,12 +1925,15 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1878
1925
  deletions: number;
1879
1926
  at?: string | undefined;
1880
1927
  title?: string | undefined;
1881
- repo?: string | undefined;
1882
1928
  hunks?: {
1883
- op: "+" | "-";
1884
1929
  text: string;
1930
+ op: "-" | "context" | "+";
1931
+ old_no?: number | undefined;
1932
+ new_no?: number | undefined;
1885
1933
  }[][] | undefined;
1934
+ repo?: string | undefined;
1886
1935
  patch?: string | undefined;
1936
+ select_hunks?: number[] | undefined;
1887
1937
  }, {
1888
1938
  path: string;
1889
1939
  type: "diff";
@@ -1892,12 +1942,15 @@ export declare const figureInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
1892
1942
  deletions: number;
1893
1943
  at?: string | undefined;
1894
1944
  title?: string | undefined;
1895
- repo?: string | undefined;
1896
1945
  hunks?: {
1897
- op: "+" | "-";
1898
1946
  text: string;
1947
+ op: "-" | "context" | "+";
1948
+ old_no?: number | undefined;
1949
+ new_no?: number | undefined;
1899
1950
  }[][] | undefined;
1951
+ repo?: string | undefined;
1900
1952
  patch?: string | undefined;
1953
+ select_hunks?: number[] | undefined;
1901
1954
  }>]>;
1902
1955
  export type FigureInput = z.infer<typeof figureInputSchema>;
1903
1956
  /** The four figure types whose fields the tool listing leaves to the guide. */
@@ -1910,6 +1963,7 @@ export declare const GUIDE_ONLY_FIGURE_TYPES: readonly ["range_overlap", "histog
1910
1963
  */
1911
1964
  export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
1912
1965
  type: z.ZodLiteral<"stats">;
1966
+ title: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
1913
1967
  items: z.ZodArray<z.ZodObject<{
1914
1968
  label: z.ZodString;
1915
1969
  value: z.ZodString;
@@ -1934,6 +1988,7 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
1934
1988
  caption?: string | undefined;
1935
1989
  tone?: "good" | "warn" | "bad" | "neutral" | undefined;
1936
1990
  }[];
1991
+ title?: string | undefined;
1937
1992
  }, {
1938
1993
  type: "stats";
1939
1994
  items: {
@@ -1942,6 +1997,7 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
1942
1997
  caption?: string | undefined;
1943
1998
  tone?: "good" | "warn" | "bad" | "neutral" | undefined;
1944
1999
  }[];
2000
+ title?: string | undefined;
1945
2001
  }>, z.ZodObject<{
1946
2002
  type: z.ZodLiteral<"compare">;
1947
2003
  title: z.ZodOptional<z.ZodString>;
@@ -1982,22 +2038,22 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
1982
2038
  label: string;
1983
2039
  before: number;
1984
2040
  after: number;
1985
- mono?: boolean | undefined;
1986
2041
  details?: {
1987
2042
  label: string;
1988
2043
  before: string;
1989
2044
  after: string;
1990
2045
  }[] | undefined;
2046
+ mono?: boolean | undefined;
1991
2047
  }, {
1992
2048
  label: string;
1993
2049
  before: number;
1994
2050
  after: number;
1995
- mono?: boolean | undefined;
1996
2051
  details?: {
1997
2052
  label: string;
1998
2053
  before: string;
1999
2054
  after: string;
2000
2055
  }[] | undefined;
2056
+ mono?: boolean | undefined;
2001
2057
  }>, "many">;
2002
2058
  }, "strict", z.ZodTypeAny, {
2003
2059
  type: "compare";
@@ -2005,12 +2061,12 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2005
2061
  label: string;
2006
2062
  before: number;
2007
2063
  after: number;
2008
- mono?: boolean | undefined;
2009
2064
  details?: {
2010
2065
  label: string;
2011
2066
  before: string;
2012
2067
  after: string;
2013
2068
  }[] | undefined;
2069
+ mono?: boolean | undefined;
2014
2070
  }[];
2015
2071
  title?: string | undefined;
2016
2072
  metric?: string | undefined;
@@ -2028,12 +2084,12 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2028
2084
  label: string;
2029
2085
  before: number;
2030
2086
  after: number;
2031
- mono?: boolean | undefined;
2032
2087
  details?: {
2033
2088
  label: string;
2034
2089
  before: string;
2035
2090
  after: string;
2036
2091
  }[] | undefined;
2092
+ mono?: boolean | undefined;
2037
2093
  }[];
2038
2094
  title?: string | undefined;
2039
2095
  metric?: string | undefined;
@@ -2066,11 +2122,11 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2066
2122
  at: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
2067
2123
  label: z.ZodString;
2068
2124
  }, "strict", z.ZodTypeAny, {
2069
- label: string;
2070
2125
  at: string | number;
2071
- }, {
2072
2126
  label: string;
2127
+ }, {
2073
2128
  at: string | number;
2129
+ label: string;
2074
2130
  }>, "many">>;
2075
2131
  marks: z.ZodOptional<z.ZodArray<z.ZodObject<{
2076
2132
  i: z.ZodNumber;
@@ -2125,6 +2181,15 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2125
2181
  type: "trend";
2126
2182
  reduce?: "max" | "min" | "mean" | "last" | undefined;
2127
2183
  title?: string | undefined;
2184
+ source?: {
2185
+ kind?: string | undefined;
2186
+ datasource?: string | undefined;
2187
+ query?: string | undefined;
2188
+ from?: string | undefined;
2189
+ to?: string | undefined;
2190
+ step?: string | undefined;
2191
+ artifact_id?: string | undefined;
2192
+ } | undefined;
2128
2193
  unit?: string | undefined;
2129
2194
  max?: number | undefined;
2130
2195
  threshold?: {
@@ -2138,22 +2203,13 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2138
2203
  label: string;
2139
2204
  i: number;
2140
2205
  }[] | undefined;
2141
- source?: {
2142
- kind?: string | undefined;
2143
- datasource?: string | undefined;
2144
- query?: string | undefined;
2145
- from?: string | undefined;
2146
- to?: string | undefined;
2147
- step?: string | undefined;
2148
- artifact_id?: string | undefined;
2149
- } | undefined;
2150
2206
  points?: {
2151
2207
  t: string | number;
2152
2208
  v: string | number | null;
2153
2209
  }[] | undefined;
2154
2210
  events?: {
2155
- label: string;
2156
2211
  at: string | number;
2212
+ label: string;
2157
2213
  }[] | undefined;
2158
2214
  max_points?: number | undefined;
2159
2215
  precision?: number | undefined;
@@ -2161,6 +2217,15 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2161
2217
  type: "trend";
2162
2218
  reduce?: "max" | "min" | "mean" | "last" | undefined;
2163
2219
  title?: string | undefined;
2220
+ source?: {
2221
+ kind?: string | undefined;
2222
+ datasource?: string | undefined;
2223
+ query?: string | undefined;
2224
+ from?: string | undefined;
2225
+ to?: string | undefined;
2226
+ step?: string | undefined;
2227
+ artifact_id?: string | undefined;
2228
+ } | undefined;
2164
2229
  unit?: string | undefined;
2165
2230
  max?: number | undefined;
2166
2231
  threshold?: {
@@ -2174,22 +2239,13 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2174
2239
  label: string;
2175
2240
  i: number;
2176
2241
  }[] | undefined;
2177
- source?: {
2178
- kind?: string | undefined;
2179
- datasource?: string | undefined;
2180
- query?: string | undefined;
2181
- from?: string | undefined;
2182
- to?: string | undefined;
2183
- step?: string | undefined;
2184
- artifact_id?: string | undefined;
2185
- } | undefined;
2186
2242
  points?: {
2187
2243
  t: string | number;
2188
2244
  v: string | number | null;
2189
2245
  }[] | undefined;
2190
2246
  events?: {
2191
- label: string;
2192
2247
  at: string | number;
2248
+ label: string;
2193
2249
  }[] | undefined;
2194
2250
  max_points?: number | undefined;
2195
2251
  precision?: number | undefined;
@@ -2236,27 +2292,27 @@ export declare const figureToolInputSchema: z.ZodDiscriminatedUnion<"type", [z.Z
2236
2292
  state: z.ZodEnum<["pass", "fail", "pending", "skipped"]>;
2237
2293
  detail: z.ZodOptional<z.ZodString>;
2238
2294
  }, "strict", z.ZodTypeAny, {
2295
+ state: "pending" | "pass" | "fail" | "skipped";
2239
2296
  label: string;
2240
- state: "pass" | "fail" | "pending" | "skipped";
2241
2297
  detail?: string | undefined;
2242
2298
  }, {
2299
+ state: "pending" | "pass" | "fail" | "skipped";
2243
2300
  label: string;
2244
- state: "pass" | "fail" | "pending" | "skipped";
2245
2301
  detail?: string | undefined;
2246
2302
  }>, "many">;
2247
2303
  }, "strict", z.ZodTypeAny, {
2248
2304
  type: "checks";
2249
2305
  items: {
2306
+ state: "pending" | "pass" | "fail" | "skipped";
2250
2307
  label: string;
2251
- state: "pass" | "fail" | "pending" | "skipped";
2252
2308
  detail?: string | undefined;
2253
2309
  }[];
2254
2310
  title?: string | undefined;
2255
2311
  }, {
2256
2312
  type: "checks";
2257
2313
  items: {
2314
+ state: "pending" | "pass" | "fail" | "skipped";
2258
2315
  label: string;
2259
- state: "pass" | "fail" | "pending" | "skipped";
2260
2316
  detail?: string | undefined;
2261
2317
  }[];
2262
2318
  title?: string | undefined;
@@ -2328,9 +2384,33 @@ export type BuildFigureResult = {
2328
2384
  * fields. Returns the problems, empty when the block is valid.
2329
2385
  */
2330
2386
  export declare function validateBlock(block: unknown): string[];
2387
+ /** What the server that will take the figure accepts. */
2388
+ export type FigureOptions = {
2389
+ /** The server lists figure_extras_v1: a stats title, more than 4 stats and runs_not_shown. */
2390
+ figureExtras?: boolean;
2391
+ /** The server lists diff_lines_v1: a diff may carry unchanged lines and line numbers. */
2392
+ diffLines?: boolean;
2393
+ };
2394
+ /**
2395
+ * A diff block as a server without diff_lines_v1 takes it: no unchanged lines
2396
+ * and no line numbers. Any other block is returned as it is.
2397
+ */
2398
+ export declare function withoutDiffLineDetailInBlock(block: unknown): {
2399
+ block: unknown;
2400
+ stripped: boolean;
2401
+ };
2402
+ /**
2403
+ * A stats or run_history block as a server without figure_extras_v1 takes it:
2404
+ * no stats title, at most four stats and no runs_not_shown. Any other block is
2405
+ * returned as it is. `what` names each thing that was left out.
2406
+ */
2407
+ export declare function withoutFigureExtrasInBlock(block: unknown): {
2408
+ block: unknown;
2409
+ what: string[];
2410
+ };
2331
2411
  /**
2332
2412
  * Turns the numbers an agent already read from a tool result into a figure
2333
2413
  * Tellagen accepts. It reshapes and checks. It has no data source of its own
2334
2414
  * and never makes up a value.
2335
2415
  */
2336
- export declare function buildFigure(input: BuildFigureInput): BuildFigureResult;
2416
+ export declare function buildFigure(input: BuildFigureInput, options?: FigureOptions): BuildFigureResult;