@crvouga/atlas 0.14.0 → 0.16.0

package/dist/schema/src/api.d.ts

@@ -80,6 +80,21 @@ export declare const BackendInfoSchema: z.ZodObject<{
     live: z.ZodBoolean;
     available: z.ZodBoolean;
 }, z.core.$loose>;
+/** One reference to a video held by a layer, check, retry attempt or step, found by the attachment's effective media type. */
+export declare const VideoRefSchema: z.ZodObject<{
+    name: z.ZodString;
+    owner: z.ZodString;
+    attempt: z.ZodOptional<z.ZodNumber>;
+    step: z.ZodOptional<z.ZodString>;
+    recording: z.ZodOptional<z.ZodString>;
+    available: z.ZodBoolean;
+}, z.core.$loose>;
+/** Video references as counts: how many are referenced, how many distinct recordings can be played, how many cannot. */
+export declare const VideoCountsSchema: z.ZodObject<{
+    references: z.ZodNumber;
+    recordings: z.ZodNumber;
+    unavailable: z.ZodNumber;
+}, z.core.$loose>;
 /** What a result carries beyond its outcome, as counts and short facts. Present only when there is something. */
 export declare const EvidenceSummarySchema: z.ZodObject<{
     attachments: z.ZodNumber;
@@ -88,8 +103,17 @@ export declare const EvidenceSummarySchema: z.ZodObject<{
     attempts: z.ZodNumber;
     links: z.ZodNumber;
     tags: z.ZodArray<z.ZodString>;
+    artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     labels: z.ZodRecord<z.ZodString, z.ZodString>;
     roles: z.ZodArray<z.ZodString>;
+    videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        owner: z.ZodString;
+        attempt: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodString>;
+        recording: z.ZodOptional<z.ZodString>;
+        available: z.ZodBoolean;
+    }, z.core.$loose>>>;
 }, z.core.$loose>;
 /** A layer as the report shows it: its origin and its checks by status. */
 export declare const LayerHeaderSchema: z.ZodObject<{
@@ -129,8 +153,17 @@ export declare const LayerHeaderSchema: z.ZodObject<{
         attempts: z.ZodNumber;
         links: z.ZodNumber;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         roles: z.ZodArray<z.ZodString>;
+        videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            owner: z.ZodString;
+            attempt: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodString>;
+            recording: z.ZodOptional<z.ZodString>;
+            available: z.ZodBoolean;
+        }, z.core.$loose>>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 /** One check of a layer as the report shows it. */
@@ -162,8 +195,17 @@ export declare const LayerRowSchema: z.ZodObject<{
         attempts: z.ZodNumber;
         links: z.ZodNumber;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         roles: z.ZodArray<z.ZodString>;
+        videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            owner: z.ZodString;
+            attempt: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodString>;
+            recording: z.ZodOptional<z.ZodString>;
+            available: z.ZodBoolean;
+        }, z.core.$loose>>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 /** A layer with its checks: the rows of one layer, read apart from its header. */
@@ -197,8 +239,17 @@ export declare const LayerRowsSchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
+            videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                owner: z.ZodString;
+                attempt: z.ZodOptional<z.ZodNumber>;
+                step: z.ZodOptional<z.ZodString>;
+                recording: z.ZodOptional<z.ZodString>;
+                available: z.ZodBoolean;
+            }, z.core.$loose>>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     fingerprints: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -234,8 +285,17 @@ export declare const LayerEvidenceSchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
+            videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                owner: z.ZodString;
+                attempt: z.ZodOptional<z.ZodNumber>;
+                step: z.ZodOptional<z.ZodString>;
+                recording: z.ZodOptional<z.ZodString>;
+                available: z.ZodBoolean;
+            }, z.core.$loose>>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     fingerprints: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -276,8 +336,17 @@ export declare const LayerEvidenceSchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
+            videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                owner: z.ZodString;
+                attempt: z.ZodOptional<z.ZodNumber>;
+                step: z.ZodOptional<z.ZodString>;
+                recording: z.ZodOptional<z.ZodString>;
+                available: z.ZodBoolean;
+            }, z.core.$loose>>>;
         }, z.core.$loose>>;
     }, z.core.$loose>;
 }, z.core.$loose>;
@@ -318,8 +387,17 @@ export declare const EffectiveEvidenceSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
+                videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    owner: z.ZodString;
+                    attempt: z.ZodOptional<z.ZodNumber>;
+                    step: z.ZodOptional<z.ZodString>;
+                    recording: z.ZodOptional<z.ZodString>;
+                    available: z.ZodBoolean;
+                }, z.core.$loose>>>;
             }, z.core.$loose>>;
         }, z.core.$loose>>;
         fingerprints: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -360,8 +438,17 @@ export declare const EffectiveEvidenceSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
+                videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    owner: z.ZodString;
+                    attempt: z.ZodOptional<z.ZodNumber>;
+                    step: z.ZodOptional<z.ZodString>;
+                    recording: z.ZodOptional<z.ZodString>;
+                    available: z.ZodBoolean;
+                }, z.core.$loose>>>;
             }, z.core.$loose>>;
         }, z.core.$loose>;
     }, z.core.$loose>>;
@@ -423,8 +510,17 @@ export declare const EffectiveDeltaSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
+                videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    owner: z.ZodString;
+                    attempt: z.ZodOptional<z.ZodNumber>;
+                    step: z.ZodOptional<z.ZodString>;
+                    recording: z.ZodOptional<z.ZodString>;
+                    available: z.ZodBoolean;
+                }, z.core.$loose>>>;
             }, z.core.$loose>>;
         }, z.core.$loose>>;
         fingerprints: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -465,8 +561,17 @@ export declare const EffectiveDeltaSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
+                videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    owner: z.ZodString;
+                    attempt: z.ZodOptional<z.ZodNumber>;
+                    step: z.ZodOptional<z.ZodString>;
+                    recording: z.ZodOptional<z.ZodString>;
+                    available: z.ZodBoolean;
+                }, z.core.$loose>>>;
             }, z.core.$loose>>;
         }, z.core.$loose>;
     }, z.core.$loose>>;
@@ -531,8 +636,17 @@ export declare const EvidencePageSchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
+            videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                owner: z.ZodString;
+                attempt: z.ZodOptional<z.ZodNumber>;
+                step: z.ZodOptional<z.ZodString>;
+                recording: z.ZodOptional<z.ZodString>;
+                available: z.ZodBoolean;
+            }, z.core.$loose>>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     cursor: z.ZodNullable<z.ZodString>;
@@ -573,6 +687,7 @@ export declare const CheckDetailSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
                     offsetMs: z.ZodOptional<z.ZodNumber>;
@@ -637,6 +752,7 @@ export declare const CheckDetailSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
                         offsetMs: z.ZodOptional<z.ZodNumber>;
@@ -681,6 +797,7 @@ export declare const CheckDetailSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
                     offsetMs: z.ZodOptional<z.ZodNumber>;
@@ -732,6 +849,7 @@ export declare const CheckDetailSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
                 offsetMs: z.ZodOptional<z.ZodNumber>;
@@ -799,6 +917,55 @@ export declare const ChecksResultSchema: z.ZodObject<{
     id: z.ZodString;
     checks: z.ZodNumber;
 }, z.core.$loose>;
+/** Which attachment a reviewer's tags belong to: one attachment of one check of one archived layer. */
+export declare const ArtifactTargetSchema: z.ZodObject<{
+    layer: z.ZodString;
+    check: z.ZodString;
+    kind: z.ZodOptional<z.ZodString>;
+    artifact: z.ZodString;
+}, z.core.$loose>;
+/** The body of `POST /api/reports/artifact-tags`: tags to add to and to remove from one attachment. At least one tag overall. */
+export declare const ArtifactTagEditSchema: z.ZodObject<{
+    target: z.ZodObject<{
+        layer: z.ZodString;
+        check: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        artifact: z.ZodString;
+    }, z.core.$loose>;
+    add: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    remove: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+/** One recorded edit of an attachment's reviewer tags. Entries are never changed or removed: they are the audit trail. */
+export declare const ArtifactTagEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    target: z.ZodObject<{
+        layer: z.ZodString;
+        check: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        artifact: z.ZodString;
+    }, z.core.$loose>;
+    add: z.ZodArray<z.ZodString>;
+    remove: z.ZodArray<z.ZodString>;
+    by: z.ZodString;
+    atMs: z.ZodNumber;
+}, z.core.$loose>;
+/** `GET /api/reports/artifact-tags`: every recorded edit, oldest first. Fold them with `foldArtifactTags`. */
+export declare const ArtifactTagsSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        target: z.ZodObject<{
+            layer: z.ZodString;
+            check: z.ZodString;
+            kind: z.ZodOptional<z.ZodString>;
+            artifact: z.ZodString;
+        }, z.core.$loose>;
+        add: z.ZodArray<z.ZodString>;
+        remove: z.ZodArray<z.ZodString>;
+        by: z.ZodString;
+        atMs: z.ZodNumber;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
 /** The data of the `hello` event: sent first on `/api/events`. */
 export declare const HelloEventSchema: z.ZodObject<{
     version: z.ZodString;
@@ -856,8 +1023,17 @@ export declare const TestResultEntrySchema: z.ZodObject<{
         attempts: z.ZodNumber;
         links: z.ZodNumber;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         roles: z.ZodArray<z.ZodString>;
+        videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            owner: z.ZodString;
+            attempt: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodString>;
+            recording: z.ZodOptional<z.ZodString>;
+            available: z.ZodBoolean;
+        }, z.core.$loose>>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 /** One test of the catalog: what it is, its current result per environment, and how it has gone over its recorded history. */
@@ -907,8 +1083,17 @@ export declare const TestSummarySchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
+            videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                owner: z.ZodString;
+                attempt: z.ZodOptional<z.ZodNumber>;
+                step: z.ZodOptional<z.ZodString>;
+                recording: z.ZodOptional<z.ZodString>;
+                available: z.ZodBoolean;
+            }, z.core.$loose>>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     stats: z.ZodObject<{
@@ -937,6 +1122,8 @@ export declare const TestSummarySchema: z.ZodObject<{
         branches: z.ZodArray<z.ZodString>;
     }, z.core.$loose>;
     tags: z.ZodArray<z.ZodString>;
+    artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    inheritedArtifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     labels: z.ZodRecord<z.ZodString, z.ZodString>;
     evidence: z.ZodObject<{
         attachments: z.ZodNumber;
@@ -1084,6 +1271,10 @@ export declare const TestCatalogSchema: z.ZodObject<{
             value: z.ZodString;
             count: z.ZodNumber;
         }, z.core.$loose>>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$loose>>>;
         branches: z.ZodArray<z.ZodObject<{
             value: z.ZodString;
             count: z.ZodNumber;
@@ -1142,8 +1333,17 @@ export declare const TestCatalogSchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
+                videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    owner: z.ZodString;
+                    attempt: z.ZodOptional<z.ZodNumber>;
+                    step: z.ZodOptional<z.ZodString>;
+                    recording: z.ZodOptional<z.ZodString>;
+                    available: z.ZodBoolean;
+                }, z.core.$loose>>>;
             }, z.core.$loose>>;
         }, z.core.$loose>>;
         stats: z.ZodObject<{
@@ -1172,6 +1372,8 @@ export declare const TestCatalogSchema: z.ZodObject<{
             branches: z.ZodArray<z.ZodString>;
         }, z.core.$loose>;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inheritedArtifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         evidence: z.ZodObject<{
             attachments: z.ZodNumber;
@@ -1312,8 +1514,17 @@ export declare const TestHistorySchema: z.ZodObject<{
                 attempts: z.ZodNumber;
                 links: z.ZodNumber;
                 tags: z.ZodArray<z.ZodString>;
+                artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 labels: z.ZodRecord<z.ZodString, z.ZodString>;
                 roles: z.ZodArray<z.ZodString>;
+                videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    owner: z.ZodString;
+                    attempt: z.ZodOptional<z.ZodNumber>;
+                    step: z.ZodOptional<z.ZodString>;
+                    recording: z.ZodOptional<z.ZodString>;
+                    available: z.ZodBoolean;
+                }, z.core.$loose>>>;
             }, z.core.$loose>>;
         }, z.core.$loose>>;
         stats: z.ZodObject<{
@@ -1342,6 +1553,8 @@ export declare const TestHistorySchema: z.ZodObject<{
             branches: z.ZodArray<z.ZodString>;
         }, z.core.$loose>;
         tags: z.ZodArray<z.ZodString>;
+        artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inheritedArtifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         labels: z.ZodRecord<z.ZodString, z.ZodString>;
         evidence: z.ZodObject<{
             attachments: z.ZodNumber;
@@ -1379,8 +1592,17 @@ export declare const TestHistorySchema: z.ZodObject<{
             attempts: z.ZodNumber;
             links: z.ZodNumber;
             tags: z.ZodArray<z.ZodString>;
+            artifactTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             labels: z.ZodRecord<z.ZodString, z.ZodString>;
             roles: z.ZodArray<z.ZodString>;
+            videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                owner: z.ZodString;
+                attempt: z.ZodOptional<z.ZodNumber>;
+                step: z.ZodOptional<z.ZodString>;
+                recording: z.ZodOptional<z.ZodString>;
+                available: z.ZodBoolean;
+            }, z.core.$loose>>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
@@ -1416,6 +1638,11 @@ export declare const ReportRunSchema: z.ZodObject<{
         environment: z.ZodNullable<z.ZodString>;
         detail: z.ZodString;
     }, z.core.$loose>>;
+    videos: z.ZodOptional<z.ZodObject<{
+        references: z.ZodNumber;
+        recordings: z.ZodNumber;
+        unavailable: z.ZodNumber;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 /** `GET /api/reports/runs`: runs, newest first. */
 export declare const RunListSchema: z.ZodObject<{
@@ -1453,7 +1680,13 @@ export declare const RunListSchema: z.ZodObject<{
             environment: z.ZodNullable<z.ZodString>;
             detail: z.ZodString;
         }, z.core.$loose>>;
+        videos: z.ZodOptional<z.ZodObject<{
+            references: z.ZodNumber;
+            recordings: z.ZodNumber;
+            unavailable: z.ZodNumber;
+        }, z.core.$loose>>;
     }, z.core.$loose>>;
+    withVideo: z.ZodOptional<z.ZodNumber>;
 }, z.core.$loose>;
 /** `GET /api/reports/runs/detail`: one run and its last result for every test, environment and producer it recorded. */
 export declare const RunDetailSchema: z.ZodObject<{
@@ -1490,6 +1723,11 @@ export declare const RunDetailSchema: z.ZodObject<{
             environment: z.ZodNullable<z.ZodString>;
             detail: z.ZodString;
         }, z.core.$loose>>;
+        videos: z.ZodOptional<z.ZodObject<{
+            references: z.ZodNumber;
+            recordings: z.ZodNumber;
+            unavailable: z.ZodNumber;
+        }, z.core.$loose>>;
     }, z.core.$loose>;
     results: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
@@ -1508,5 +1746,13 @@ export declare const RunDetailSchema: z.ZodObject<{
         at: z.ZodNumber;
         layer: z.ZodString;
         detail: z.ZodString;
+        videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            owner: z.ZodString;
+            attempt: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodString>;
+            recording: z.ZodOptional<z.ZodString>;
+            available: z.ZodBoolean;
+        }, z.core.$loose>>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;

package/dist/schema/src/api.js

@@ -62,6 +62,21 @@ export const BackendInfoSchema = z.looseObject({
     live: z.boolean().describe('Always false on a server'),
     available: z.boolean().describe('False when the backend could not be read; its results are then unknown, never passed')
 });
+/** One reference to a video held by a layer, check, retry attempt or step, found by the attachment's effective media type. */
+export const VideoRefSchema = z.looseObject({
+    name: z.string().describe('The attachment name'),
+    owner: z.string().describe('Who holds it: `layer`, `check`, `attempt` or `step`. An open vocabulary: treat an unknown owner as a check'),
+    attempt: z.number().int().nonnegative().optional().describe('The retry attempt that holds it, or that holds the step that does'),
+    step: z.string().optional().describe('The name of the step that holds it'),
+    recording: z.string().optional().describe('What identifies the bytes; references with the same value are one recording. Absent when it cannot be played'),
+    available: z.boolean().describe('False when the reference names no bytes (no bundle key, address or inline text)')
+});
+/** Video references as counts: how many are referenced, how many distinct recordings can be played, how many cannot. */
+export const VideoCountsSchema = z.looseObject({
+    references: z.number().int().nonnegative().describe('Every reference to a video; identical bytes referenced twice count twice'),
+    recordings: z.number().int().nonnegative().describe('Distinct playable recordings'),
+    unavailable: z.number().int().nonnegative().describe('References that name no bytes')
+});
 /** What a result carries beyond its outcome, as counts and short facts. Present only when there is something. */
 export const EvidenceSummarySchema = z.looseObject({
     attachments: z.number().int().nonnegative(),
@@ -70,8 +85,10 @@ export const EvidenceSummarySchema = z.looseObject({
     attempts: z.number().int().nonnegative(),
     links: z.number().int().nonnegative(),
     tags: z.array(z.string()),
+    artifactTags: z.array(z.string()).optional().describe('Normalized tags of the attachments themselves, sorted and distinct. Absent when no attachment is tagged; never inherited from a check or run'),
     labels: z.record(z.string(), z.string()),
-    roles: z.array(z.string())
+    roles: z.array(z.string()),
+    videos: z.array(VideoRefSchema).optional().describe('Its references to videos and who holds each. Absent when it has none, and in reports written before this was recorded')
 });
 /** A layer as the report shows it: its origin and its checks by status. */
 export const LayerHeaderSchema = z.looseObject({
@@ -186,6 +203,33 @@ export const ChecksResultSchema = z.looseObject({
     id: z.string().describe('The layer id'),
     checks: z.number().int().nonnegative()
 });
+/** Which attachment a reviewer's tags belong to: one attachment of one check of one archived layer. */
+export const ArtifactTargetSchema = z.looseObject({
+    layer: z.string().regex(/^[0-9a-f]{64}$/).describe('The id of the archived layer that holds the check'),
+    check: z.string().min(1).describe('The check\'s id'),
+    kind: z.string().min(1).optional().describe('The kind of the part holding the check, when the same id exists in several parts'),
+    artifact: z.string().min(1).max(1024).describe('The attachment: `id:<id>` when it has an id, else `key:<bundleKey>`, else `name:<name>` (see `artifactRef`)')
+});
+/** The body of `POST /api/reports/artifact-tags`: tags to add to and to remove from one attachment. At least one tag overall. */
+export const ArtifactTagEditSchema = z.looseObject({
+    target: ArtifactTargetSchema,
+    add: z.array(z.string()).max(20).optional().describe('Tags to add. `demo` and `#demo` are the same tag'),
+    remove: z.array(z.string()).max(20).optional().describe('Reviewer tags to remove. Tags the producer wrote are part of the immutable layer and stay')
+});
+/** One recorded edit of an attachment's reviewer tags. Entries are never changed or removed: they are the audit trail. */
+export const ArtifactTagEntrySchema = z.looseObject({
+    id: z.string().describe('Unique and time-ordered'),
+    target: ArtifactTargetSchema,
+    add: z.array(z.string()).describe('Normalized tags added'),
+    remove: z.array(z.string()).describe('Normalized tags removed'),
+    by: z.string().describe('The name of the token that made the edit (never the token)'),
+    atMs: z.number().describe('When the server recorded it, epoch milliseconds')
+});
+/** `GET /api/reports/artifact-tags`: every recorded edit, oldest first. Fold them with `foldArtifactTags`. */
+export const ArtifactTagsSchema = z.looseObject({
+    schemaVersion: z.literal(1),
+    entries: z.array(ArtifactTagEntrySchema)
+});
 /** The data of the `hello` event: sent first on `/api/events`. */
 export const HelloEventSchema = z.looseObject({ version: z.string(), ready: z.boolean(), time: z.number(), heartbeatMs: z.number().positive().optional() });
 /** The data of the `report` event: layers arrived. Enough to say who sent what, without asking. */
@@ -243,6 +287,8 @@ export const TestSummarySchema = z.looseObject({
         runs: z.number().int().nonnegative(), branches: z.array(z.string())
     }),
     tags: z.array(z.string()),
+    artifactTags: z.array(z.string()).optional().describe('Normalized tags of the attachments of its current results, such as `demo` (shown `#demo`). Not inherited from a check or run, unlike `tags`'),
+    inheritedArtifactTags: z.array(z.string()).optional().describe('Normalized tags its attachments inherit from their check and run, apart from `artifactTags`: what `?artifactTag=…&inherited=1` also matches'),
     labels: z.record(z.string(), z.string()),
     evidence: z.looseObject({ attachments: z.number().int().nonnegative(), steps: z.number().int().nonnegative(), attempts: z.number().int().nonnegative(), roles: z.array(z.string()) }),
     lastRecordedAtMs: z.number(),
@@ -269,7 +315,7 @@ export const TestCatalogSchema = z.looseObject({
     facets: z.looseObject({
         statuses: z.array(FacetValueSchema), environments: z.array(FacetValueSchema), producers: z.array(FacetValueSchema), domains: z.array(FacetValueSchema),
         specs: z.array(CatalogSpecSchema.extend({ tests: z.number().int().nonnegative(), counts: StatusCountsSchema })),
-        tags: z.array(FacetValueSchema), branches: z.array(FacetValueSchema), labels: z.record(z.string(), z.array(FacetValueSchema))
+        tags: z.array(FacetValueSchema), artifactTags: z.array(FacetValueSchema).optional(), branches: z.array(FacetValueSchema), labels: z.record(z.string(), z.array(FacetValueSchema))
     }),
     total: z.number().int().nonnegative().describe('Tests the query matched, before offset and limit'),
     offset: z.number().int().nonnegative(),
@@ -344,10 +390,17 @@ export const ReportRunSchema = z.looseObject({
     producers: z.array(z.string()), environments: z.array(z.string()),
     layers: z.number().int().nonnegative(), tests: z.number().int().nonnegative(), counts: StatusCountsSchema,
     totalDurationMs: z.number().nullable(),
-    failing: z.array(z.looseObject({ key: z.string(), title: z.string(), environment: z.string().nullable(), detail: z.string() }))
+    failing: z.array(z.looseObject({ key: z.string(), title: z.string(), environment: z.string().nullable(), detail: z.string() })),
+    videos: VideoCountsSchema.optional().describe('Its videos, from its layers and the last result of each test. Absent when it has none or the report carries no video information')
 });
 /** `GET /api/reports/runs`: runs, newest first. */
-export const RunListSchema = z.looseObject({ schemaVersion: z.literal(1), version: z.string(), total: z.number().int().nonnegative(), runs: z.array(ReportRunSchema) });
+export const RunListSchema = z.looseObject({
+    schemaVersion: z.literal(1),
+    version: z.string(),
+    total: z.number().int().nonnegative().describe('Runs that matched, before `limit`'),
+    runs: z.array(ReportRunSchema),
+    withVideo: z.number().int().nonnegative().optional().describe('How many of all runs (before `video` and `limit`) have a playable video recording')
+});
 /** `GET /api/reports/runs/detail`: one run and its last result for every test, environment and producer it recorded. */
 export const RunDetailSchema = z.looseObject({
     schemaVersion: z.literal(1),
@@ -355,6 +408,7 @@ export const RunDetailSchema = z.looseObject({
     run: ReportRunSchema,
     results: z.array(z.looseObject({
         key: z.string(), id: z.string(), title: z.string(), specPath: z.string().nullable(), environment: z.string().nullable(), producer: z.string(),
-        status: EvidenceStatusSchema, durationMs: z.number().nullable(), at: z.number(), layer: z.string(), detail: z.string()
+        status: EvidenceStatusSchema, durationMs: z.number().nullable(), at: z.number(), layer: z.string(), detail: z.string(),
+        videos: z.array(VideoRefSchema).optional().describe('Every video its evidence references, with who holds it')
     }))
 });