@crvouga/atlas 1.1.0 → 1.3.0

package/dist/reports/src/reports-route.d.ts

@@ -105,6 +105,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                 } | null;
                 parts: readonly {
                     tags?: string[] | undefined;
+                    scope?: {
+                        [x: string]: import("hono/utils/types").JSONValue;
+                        surface?: string | undefined;
+                        deviceKind?: string | undefined;
+                        syntheticData?: boolean | undefined;
+                        dependencies?: string | undefined;
+                        audioCaptured?: boolean | undefined;
+                        pacing?: string | undefined;
+                        asserted?: string[] | undefined;
+                        limitations?: string[] | undefined;
+                        declaredBy?: string | undefined;
+                        verified?: string[] | undefined;
+                        verifiedBy?: string | undefined;
+                        provenance?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                            url: string;
+                            name?: string | undefined;
+                            rel?: string | undefined;
+                        }[] | undefined;
+                        extensions?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                        } | undefined;
+                    } | undefined;
                     attachments?: {
                         [x: string]: import("hono/utils/types").JSONValue;
                         name: string;
@@ -121,6 +144,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                         durationMs?: number | undefined;
                         description?: string | undefined;
                         omitted?: string | undefined;
+                        scope?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                            surface?: string | undefined;
+                            deviceKind?: string | undefined;
+                            syntheticData?: boolean | undefined;
+                            dependencies?: string | undefined;
+                            audioCaptured?: boolean | undefined;
+                            pacing?: string | undefined;
+                            asserted?: string[] | undefined;
+                            limitations?: string[] | undefined;
+                            declaredBy?: string | undefined;
+                            verified?: string[] | undefined;
+                            verifiedBy?: string | undefined;
+                            provenance?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                url: string;
+                                name?: string | undefined;
+                                rel?: string | undefined;
+                            }[] | undefined;
+                            extensions?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                            } | undefined;
+                        } | undefined;
                         tags?: string[] | undefined;
                         at?: {
                             [x: string]: import("hono/utils/types").JSONValue;
@@ -140,6 +186,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                         durationMs?: number | undefined;
                         startedAtMs?: number | undefined;
                         detail?: string | undefined;
+                        scope?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                            surface?: string | undefined;
+                            deviceKind?: string | undefined;
+                            syntheticData?: boolean | undefined;
+                            dependencies?: string | undefined;
+                            audioCaptured?: boolean | undefined;
+                            pacing?: string | undefined;
+                            asserted?: string[] | undefined;
+                            limitations?: string[] | undefined;
+                            declaredBy?: string | undefined;
+                            verified?: string[] | undefined;
+                            verifiedBy?: string | undefined;
+                            provenance?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                url: string;
+                                name?: string | undefined;
+                                rel?: string | undefined;
+                            }[] | undefined;
+                            extensions?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                            } | undefined;
+                        } | undefined;
                         steps?: {
                             [x: string]: import("hono/utils/types").JSONValue;
                             name: string;
@@ -166,6 +235,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                                 durationMs?: number | undefined;
                                 description?: string | undefined;
                                 omitted?: string | undefined;
+                                scope?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    surface?: string | undefined;
+                                    deviceKind?: string | undefined;
+                                    syntheticData?: boolean | undefined;
+                                    dependencies?: string | undefined;
+                                    audioCaptured?: boolean | undefined;
+                                    pacing?: string | undefined;
+                                    asserted?: string[] | undefined;
+                                    limitations?: string[] | undefined;
+                                    declaredBy?: string | undefined;
+                                    verified?: string[] | undefined;
+                                    verifiedBy?: string | undefined;
+                                    provenance?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                        url: string;
+                                        name?: string | undefined;
+                                        rel?: string | undefined;
+                                    }[] | undefined;
+                                    extensions?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                    } | undefined;
+                                } | undefined;
                                 tags?: string[] | undefined;
                                 at?: {
                                     [x: string]: import("hono/utils/types").JSONValue;
@@ -224,6 +316,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                             durationMs?: number | undefined;
                             description?: string | undefined;
                             omitted?: string | undefined;
+                            scope?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                surface?: string | undefined;
+                                deviceKind?: string | undefined;
+                                syntheticData?: boolean | undefined;
+                                dependencies?: string | undefined;
+                                audioCaptured?: boolean | undefined;
+                                pacing?: string | undefined;
+                                asserted?: string[] | undefined;
+                                limitations?: string[] | undefined;
+                                declaredBy?: string | undefined;
+                                verified?: string[] | undefined;
+                                verifiedBy?: string | undefined;
+                                provenance?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    url: string;
+                                    name?: string | undefined;
+                                    rel?: string | undefined;
+                                }[] | undefined;
+                                extensions?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                } | undefined;
+                            } | undefined;
                             tags?: string[] | undefined;
                             at?: {
                                 [x: string]: import("hono/utils/types").JSONValue;
@@ -292,6 +407,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                             durationMs?: number | undefined;
                             description?: string | undefined;
                             omitted?: string | undefined;
+                            scope?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                surface?: string | undefined;
+                                deviceKind?: string | undefined;
+                                syntheticData?: boolean | undefined;
+                                dependencies?: string | undefined;
+                                audioCaptured?: boolean | undefined;
+                                pacing?: string | undefined;
+                                asserted?: string[] | undefined;
+                                limitations?: string[] | undefined;
+                                declaredBy?: string | undefined;
+                                verified?: string[] | undefined;
+                                verifiedBy?: string | undefined;
+                                provenance?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    url: string;
+                                    name?: string | undefined;
+                                    rel?: string | undefined;
+                                }[] | undefined;
+                                extensions?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                } | undefined;
+                            } | undefined;
                             tags?: string[] | undefined;
                             at?: {
                                 [x: string]: import("hono/utils/types").JSONValue;
@@ -383,6 +521,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                     readonly recordedAtMs: number;
                     readonly checks: readonly {
                         tags?: string[] | undefined;
+                        scope?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                            surface?: string | undefined;
+                            deviceKind?: string | undefined;
+                            syntheticData?: boolean | undefined;
+                            dependencies?: string | undefined;
+                            audioCaptured?: boolean | undefined;
+                            pacing?: string | undefined;
+                            asserted?: string[] | undefined;
+                            limitations?: string[] | undefined;
+                            declaredBy?: string | undefined;
+                            verified?: string[] | undefined;
+                            verifiedBy?: string | undefined;
+                            provenance?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                url: string;
+                                name?: string | undefined;
+                                rel?: string | undefined;
+                            }[] | undefined;
+                            extensions?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                            } | undefined;
+                        } | undefined;
                         attachments?: {
                             [x: string]: import("hono/utils/types").JSONValue;
                             name: string;
@@ -399,6 +560,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                             durationMs?: number | undefined;
                             description?: string | undefined;
                             omitted?: string | undefined;
+                            scope?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                surface?: string | undefined;
+                                deviceKind?: string | undefined;
+                                syntheticData?: boolean | undefined;
+                                dependencies?: string | undefined;
+                                audioCaptured?: boolean | undefined;
+                                pacing?: string | undefined;
+                                asserted?: string[] | undefined;
+                                limitations?: string[] | undefined;
+                                declaredBy?: string | undefined;
+                                verified?: string[] | undefined;
+                                verifiedBy?: string | undefined;
+                                provenance?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    url: string;
+                                    name?: string | undefined;
+                                    rel?: string | undefined;
+                                }[] | undefined;
+                                extensions?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                } | undefined;
+                            } | undefined;
                             tags?: string[] | undefined;
                             at?: {
                                 [x: string]: import("hono/utils/types").JSONValue;
@@ -418,6 +602,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                             durationMs?: number | undefined;
                             startedAtMs?: number | undefined;
                             detail?: string | undefined;
+                            scope?: {
+                                [x: string]: import("hono/utils/types").JSONValue;
+                                surface?: string | undefined;
+                                deviceKind?: string | undefined;
+                                syntheticData?: boolean | undefined;
+                                dependencies?: string | undefined;
+                                audioCaptured?: boolean | undefined;
+                                pacing?: string | undefined;
+                                asserted?: string[] | undefined;
+                                limitations?: string[] | undefined;
+                                declaredBy?: string | undefined;
+                                verified?: string[] | undefined;
+                                verifiedBy?: string | undefined;
+                                provenance?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    url: string;
+                                    name?: string | undefined;
+                                    rel?: string | undefined;
+                                }[] | undefined;
+                                extensions?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                } | undefined;
+                            } | undefined;
                             steps?: {
                                 [x: string]: import("hono/utils/types").JSONValue;
                                 name: string;
@@ -444,6 +651,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                                     durationMs?: number | undefined;
                                     description?: string | undefined;
                                     omitted?: string | undefined;
+                                    scope?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                        surface?: string | undefined;
+                                        deviceKind?: string | undefined;
+                                        syntheticData?: boolean | undefined;
+                                        dependencies?: string | undefined;
+                                        audioCaptured?: boolean | undefined;
+                                        pacing?: string | undefined;
+                                        asserted?: string[] | undefined;
+                                        limitations?: string[] | undefined;
+                                        declaredBy?: string | undefined;
+                                        verified?: string[] | undefined;
+                                        verifiedBy?: string | undefined;
+                                        provenance?: {
+                                            [x: string]: import("hono/utils/types").JSONValue;
+                                            url: string;
+                                            name?: string | undefined;
+                                            rel?: string | undefined;
+                                        }[] | undefined;
+                                        extensions?: {
+                                            [x: string]: import("hono/utils/types").JSONValue;
+                                        } | undefined;
+                                    } | undefined;
                                     tags?: string[] | undefined;
                                     at?: {
                                         [x: string]: import("hono/utils/types").JSONValue;
@@ -502,6 +732,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                                 durationMs?: number | undefined;
                                 description?: string | undefined;
                                 omitted?: string | undefined;
+                                scope?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    surface?: string | undefined;
+                                    deviceKind?: string | undefined;
+                                    syntheticData?: boolean | undefined;
+                                    dependencies?: string | undefined;
+                                    audioCaptured?: boolean | undefined;
+                                    pacing?: string | undefined;
+                                    asserted?: string[] | undefined;
+                                    limitations?: string[] | undefined;
+                                    declaredBy?: string | undefined;
+                                    verified?: string[] | undefined;
+                                    verifiedBy?: string | undefined;
+                                    provenance?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                        url: string;
+                                        name?: string | undefined;
+                                        rel?: string | undefined;
+                                    }[] | undefined;
+                                    extensions?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                    } | undefined;
+                                } | undefined;
                                 tags?: string[] | undefined;
                                 at?: {
                                     [x: string]: import("hono/utils/types").JSONValue;
@@ -570,6 +823,29 @@ export declare function createReportsApp(deps: ReportsAppDeps): import("hono/hon
                                 durationMs?: number | undefined;
                                 description?: string | undefined;
                                 omitted?: string | undefined;
+                                scope?: {
+                                    [x: string]: import("hono/utils/types").JSONValue;
+                                    surface?: string | undefined;
+                                    deviceKind?: string | undefined;
+                                    syntheticData?: boolean | undefined;
+                                    dependencies?: string | undefined;
+                                    audioCaptured?: boolean | undefined;
+                                    pacing?: string | undefined;
+                                    asserted?: string[] | undefined;
+                                    limitations?: string[] | undefined;
+                                    declaredBy?: string | undefined;
+                                    verified?: string[] | undefined;
+                                    verifiedBy?: string | undefined;
+                                    provenance?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                        url: string;
+                                        name?: string | undefined;
+                                        rel?: string | undefined;
+                                    }[] | undefined;
+                                    extensions?: {
+                                        [x: string]: import("hono/utils/types").JSONValue;
+                                    } | undefined;
+                                } | undefined;
                                 tags?: string[] | undefined;
                                 at?: {
                                     [x: string]: import("hono/utils/types").JSONValue;

package/dist/reports/src/test-catalog.d.ts

@@ -1,3 +1,4 @@
+import { type ArtifactFilter, type FilterFields, type FilterName, type QueryFacets } from './artifact-query.js';
 import type { EvidenceStatus, SpecEntry } from './explorer-types.js';
 import type { EvidenceSummary, LayerEvidence, LayerHeader, LayerRow, StatusCounts, VideoCounts, VideoRef } from './evidence-types.js';
 import { RecordedSpecs } from './recorded-specs.js';
@@ -98,6 +99,8 @@ export type TestSummary = {
     readonly artifactTags?: readonly string[];
     /** The normalized tags its attachments inherit from their check and run (those of the results that have attachments), apart from `artifactTags`. What an inherited artifact query also matches. */
     readonly inheritedArtifactTags?: readonly string[];
+    /** What each distinct playable recording of its current results declares it shows, as filter tokens (`device:physical`, `audio:silent`; see `scopeTokens`). A recording that declared nothing is `['unknown']`. Absent when it has no playable recording. A query's `scope` must hold for one recording, so evidence from two different devices never combines. */
+    readonly scopeProfiles?: readonly (readonly string[])[];
     readonly labels: Readonly<Record<string, string>>;
     /** What its current results carry: attachments, steps, retries, and the kinds of attachment. */
     readonly evidence: {
@@ -171,6 +174,8 @@ export type CatalogFacets = {
     readonly tags: readonly FacetValue[];
     /** The tags of attachments, normalized. Absent in documents of older servers. */
     readonly artifactTags?: readonly FacetValue[];
+    /** The scope tokens of its recordings (`device:simulator`, `audio:recorded`, `unknown`), with how many tests have a recording that states each. Absent in documents of older servers. */
+    readonly scopes?: readonly FacetValue[];
     readonly branches: readonly FacetValue[];
     readonly labels: Readonly<Record<string, readonly FacetValue[]>>;
 };
@@ -194,6 +199,8 @@ export type TestQuery = {
     readonly artifactTag?: readonly string[];
     /** With `artifactTag`: also match the tags an attachment inherits from its check and run (a recording without a tag of its own under a run tagged `demo`). Default false: the exact query. */
     readonly inherited?: boolean;
+    /** Only tests with one playable recording that states every one of these (`device:physical`, `audio:recorded`, `data:synthetic`, `dependencies:live`, `surface:browser`, `pacing:paced`; see `scopeTokens`). Evidence that did not declare a value never matches it; `unknown` matches only a recording that declared no scope. */
+    readonly scope?: readonly string[];
     /** Only tests recorded in this run (a key from `runList`). */
     readonly run?: string;
     readonly sort?: TestSort;
@@ -263,12 +270,20 @@ export type RunSummary = {
      * and references that cannot be played. Absent when it has none, and in a report that carries no video information.
      */
     readonly videos?: VideoCounts;
+    /** The normalized tags of the attachments of its results and layers, sorted and distinct. Absent when none is tagged. */
+    readonly artifactTags?: readonly string[];
+    /** The tags of its checks and layers, which its attachments inherit (what `inherited=1` also matches), sorted and distinct. Absent when none. */
+    readonly tags?: readonly string[];
+    /** The media types (roles) of its attachments, sorted and distinct; `video` only for a playable recording. Absent when it has no attachment. */
+    readonly types?: readonly string[];
+    /** The `key=value` labels of its results and layers, sorted and distinct. Absent when none. */
+    readonly labels?: readonly string[];
 };
-/** What `runList` can be asked. */
-export type RunQuery = {
-    /** Only runs that have at least one playable video recording. `total` then counts only those. */
-    readonly video?: boolean;
-};
+/**
+ * What `runList` can be asked: an {@link ArtifactFilter}, of which a run answers every dimension but `domain` and
+ * `spec`. `video` keeps only runs that have at least one playable video recording; `total` then counts only those.
+ */
+export type RunQuery = ArtifactFilter;
 /** `GET /api/reports/runs`: runs, newest first. */
 export type RunList = {
     readonly schemaVersion: typeof TEST_CATALOG_VERSION;
@@ -278,6 +293,10 @@ export type RunList = {
     readonly runs: readonly RunSummary[];
     /** How many of all runs (whatever was asked, before `limit`) have a playable video recording. */
     readonly withVideo?: number;
+    /** The filters of the query that were applied. A viewer that asked for another knows the server ignored it. */
+    readonly filters?: readonly FilterName[];
+    /** The values each filter dimension offers with counts over every run (see `facetsOf`). */
+    readonly facets?: QueryFacets;
 };
 /** One test's last result within one run. */
 export type RunResult = {
@@ -302,6 +321,60 @@ export type RunDetail = {
     readonly run: RunSummary;
     readonly results: readonly RunResult[];
 };
+/**
+ * One recorded result that carries evidence (an attachment: a recording, a screenshot, a trace), with where and when it
+ * was recorded: the unit `artifactList` finds. It is a result in the history, not only the report's current winner, so
+ * a recording tagged `demo` is found with its original run, revision and status even when a later attempt is untagged.
+ */
+export type ArtifactResult = {
+    /** The test's key, as in `TestSummary.key`. */
+    readonly key: string;
+    readonly id: string;
+    readonly title: string;
+    readonly specPath: string | null;
+    /** The domain of its spec, or null when it has none. */
+    readonly domain: string | null;
+    /** When it was recorded, epoch ms. */
+    readonly at: number;
+    readonly status: EvidenceStatus;
+    readonly environment: string | null;
+    readonly producer: string;
+    /** The kind of the part that held it. */
+    readonly kind: string;
+    readonly parameters: Readonly<Record<string, string>>;
+    readonly branch: string | null;
+    readonly sha: string | null;
+    /** The key of its run (see `runKey`). */
+    readonly run: string;
+    readonly runUrl: string | null;
+    /** The id of the layer that recorded it: with `key`, the exact result to open. */
+    readonly layer: string;
+    readonly backend: string;
+    /** Attachments on the result, including those on its steps and attempts. */
+    readonly attachments: number;
+    /** The normalized tags of its attachments. */
+    readonly artifactTags: readonly string[];
+    /** The tags of its check and run, which its attachments inherit. */
+    readonly tags: readonly string[];
+    /** The media types (roles) of its attachments; `video` only for a playable recording. */
+    readonly types: readonly string[];
+    readonly labels: Readonly<Record<string, string>>;
+    readonly videos?: readonly VideoRef[];
+};
+/** `GET /api/reports/artifacts`: the recorded results that carry evidence and match a query, newest first. */
+export type ArtifactList = {
+    readonly schemaVersion: typeof TEST_CATALOG_VERSION;
+    readonly version: string;
+    /** Results that matched, before `offset` and `limit`. */
+    readonly total: number;
+    readonly offset: number;
+    readonly limit: number;
+    readonly results: readonly ArtifactResult[];
+    /** The filters of the query that were applied. */
+    readonly filters: readonly FilterName[];
+    /** The values each dimension offers with disjunctive counts over every result that carries evidence. */
+    readonly facets: QueryFacets;
+};
 /**
  * The run a layer belongs to: the execution its producer named (`run:<id>`), else its run URL, else `branch@sha`, else
  * `local`. Layers with the same key are one run. Only grouping: it is never part of the slot a result fills.
@@ -351,6 +424,14 @@ export declare class TestHistory {
         readonly run: RunSummary;
         readonly results: RunResult[];
     } | null;
+    /**
+     * Every recorded result that carries an attachment, newest first, with the values a query looks at. Built once per
+     * layer added. The domain is left to the caller (`artifactList`), which may know more specs than the layers recorded.
+     */
+    evidenceResults(): readonly {
+        readonly result: ArtifactResult;
+        readonly fields: FilterFields;
+    }[];
     /** The keys of the tests one run recorded. */
     testsIn(key: string): ReadonlySet<string>;
 }
@@ -403,9 +484,28 @@ export declare function hasVideo(run: Pick<RunSummary, 'videos'>): boolean;
  * any recording's bytes. `withVideo` always counts every run that has one.
  */
 export declare function runList(history: TestHistory, version: string, limit?: number, query?: RunQuery): RunList;
+/** What a query looks at in a run: see {@link ArtifactFilter}. A run's outcome is `failed` when any result failed. */
+export declare function fieldsOfRun(run: RunSummary): FilterFields;
+/**
+ * The recorded results that carry evidence and match a query, newest first, across the whole history (`limit` default
+ * 100). `total` and the facet counts apply to every match before `offset` and `limit`. `domainOf` tells the domain of a
+ * spec path when the caller knows more than the layers recorded (a server with a spec set); otherwise it is the
+ * recorded spec's domain, else the folder the path implies.
+ *
+ * @example
+ * ```ts
+ * const list = artifactList(history, 'v1', { artifactTag: ['demo'], type: ['video'], environment: ['ios'] });
+ * list.results.map(r => [r.title, r.run, r.sha, r.status]);
+ * ```
+ */
+export declare function artifactList(history: TestHistory, version: string, query?: ArtifactFilter, page?: {
+    readonly limit?: number;
+    readonly offset?: number;
+    readonly domainOf?: (specPath: string) => string | undefined;
+}): ArtifactList;
 /** One run with every result it recorded, or null when no run has that key. */
 export declare function runDetail(history: TestHistory, version: string, key: string): RunDetail | null;
-/** Reads a `TestQuery` from URL search parameters: `q`, `sort`, `offset`, `limit`, `run`, and repeatable or comma-separated `status`, `environment`, `producer`, `domain`, `spec`, `tag`, `artifactTag`, and `inherited=1`. */
+/** Reads a `TestQuery` from URL search parameters: `q`, `sort`, `offset`, `limit`, `run`, and repeatable or comma-separated `status`, `environment`, `producer`, `domain`, `spec`, `tag`, `artifactTag`, `scope` (every token must hold for one recording), and `inherited=1`. */
 export declare function parseTestQuery(params: URLSearchParams): TestQuery;
 /** A duration for a person: `850 ms`, `12.3 s`, `4m 05s`. */
 export declare function formatMs(ms: number | null | undefined): string;
@@ -415,5 +515,7 @@ export declare function catalogMarkdown(catalog: TestCatalog): string;
 export declare function historyMarkdown(document: TestHistoryDocument): string;
 /** The run list as Markdown. */
 export declare function runsMarkdown(list: RunList): string;
+/** The artifact results as Markdown, for an agent or a terminal. */
+export declare function artifactsMarkdown(list: ArtifactList): string;
 /** One run as Markdown. */
 export declare function runMarkdown(detail: RunDetail): string;