@crvouga/atlas 0.16.0 → 1.0.0

package/dist/schema/src/cli-results.d.ts

@@ -29,10 +29,30 @@ export declare const PublishedLayerSchema: z.ZodObject<{
     }>>;
     attachmentFiles: z.ZodNumber;
     attachmentBytes: z.ZodNumber;
+    recordings: z.ZodOptional<z.ZodObject<{
+        expected: z.ZodNumber;
+        uploaded: z.ZodNumber;
+        referenced: z.ZodNumber;
+        skipped: z.ZodNumber;
+        unresolved: z.ZodNumber;
+        notApplicable: z.ZodNumber;
+        items: z.ZodArray<z.ZodObject<{
+            check: z.ZodString;
+            state: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                state: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 /** What `atlas report publish --format json` prints. */
 export declare const PublishResultSchema: z.ZodObject<{
-    ok: z.ZodLiteral<true>;
+    ok: z.ZodBoolean;
     store: z.ZodString;
     layer: z.ZodObject<{
         id: z.ZodString;
@@ -49,6 +69,26 @@ export declare const PublishResultSchema: z.ZodObject<{
         }>>;
         attachmentFiles: z.ZodNumber;
         attachmentBytes: z.ZodNumber;
+        recordings: z.ZodOptional<z.ZodObject<{
+            expected: z.ZodNumber;
+            uploaded: z.ZodNumber;
+            referenced: z.ZodNumber;
+            skipped: z.ZodNumber;
+            unresolved: z.ZodNumber;
+            notApplicable: z.ZodNumber;
+            items: z.ZodArray<z.ZodObject<{
+                check: z.ZodString;
+                state: z.ZodString;
+                reason: z.ZodOptional<z.ZodString>;
+                files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    state: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodOptional<z.ZodNumber>;
+                    sha256: z.ZodOptional<z.ZodString>;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
     }, z.core.$loose>;
     specSet: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
@@ -61,6 +101,17 @@ export declare const PublishResultSchema: z.ZodObject<{
         bytes: z.ZodNumber;
         alreadyPublished: z.ZodBoolean;
     }, z.core.$loose>>;
+    recordings: z.ZodOptional<z.ZodObject<{
+        strict: z.ZodBoolean;
+        complete: z.ZodBoolean;
+        expected: z.ZodNumber;
+        uploaded: z.ZodNumber;
+        gaps: z.ZodArray<z.ZodObject<{
+            check: z.ZodString;
+            state: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
     warnings: z.ZodArray<z.ZodString>;
 }, z.core.$loose>;
 /** What `atlas report stream --format json` prints when its input ends. */
@@ -288,7 +339,7 @@ export declare const CLI_RESULTS: {
         readonly command: "atlas report publish";
         readonly schemaName: "publish-result";
         readonly schema: z.ZodObject<{
-            ok: z.ZodLiteral<true>;
+            ok: z.ZodBoolean;
             store: z.ZodString;
             layer: z.ZodObject<{
                 id: z.ZodString;
@@ -305,6 +356,26 @@ export declare const CLI_RESULTS: {
                 }>>;
                 attachmentFiles: z.ZodNumber;
                 attachmentBytes: z.ZodNumber;
+                recordings: z.ZodOptional<z.ZodObject<{
+                    expected: z.ZodNumber;
+                    uploaded: z.ZodNumber;
+                    referenced: z.ZodNumber;
+                    skipped: z.ZodNumber;
+                    unresolved: z.ZodNumber;
+                    notApplicable: z.ZodNumber;
+                    items: z.ZodArray<z.ZodObject<{
+                        check: z.ZodString;
+                        state: z.ZodString;
+                        reason: z.ZodOptional<z.ZodString>;
+                        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            name: z.ZodString;
+                            state: z.ZodOptional<z.ZodString>;
+                            bytes: z.ZodOptional<z.ZodNumber>;
+                            sha256: z.ZodOptional<z.ZodString>;
+                            reason: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>>;
+                    }, z.core.$loose>>;
+                }, z.core.$loose>>;
             }, z.core.$loose>;
             specSet: z.ZodOptional<z.ZodObject<{
                 id: z.ZodString;
@@ -317,6 +388,17 @@ export declare const CLI_RESULTS: {
                 bytes: z.ZodNumber;
                 alreadyPublished: z.ZodBoolean;
             }, z.core.$loose>>;
+            recordings: z.ZodOptional<z.ZodObject<{
+                strict: z.ZodBoolean;
+                complete: z.ZodBoolean;
+                expected: z.ZodNumber;
+                uploaded: z.ZodNumber;
+                gaps: z.ZodArray<z.ZodObject<{
+                    check: z.ZodString;
+                    state: z.ZodString;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
             warnings: z.ZodArray<z.ZodString>;
         }, z.core.$loose>;
     };
@@ -425,6 +507,29 @@ export declare const CLI_RESULTS: {
                 runUrl: z.ZodNullable<z.ZodString>;
                 detail: z.ZodString;
             }, z.core.$loose>>;
+            recordings: z.ZodOptional<z.ZodObject<{
+                state: z.ZodEnum<{
+                    unknown: "unknown";
+                    complete: "complete";
+                    incomplete: "incomplete";
+                    "none-expected": "none-expected";
+                }>;
+                expected: z.ZodNumber;
+                uploaded: z.ZodNumber;
+                referenced: z.ZodNumber;
+                skipped: z.ZodNumber;
+                unresolved: z.ZodNumber;
+                notApplicable: z.ZodNumber;
+                layersWithoutReceipt: z.ZodNumber;
+                gaps: z.ZodArray<z.ZodObject<{
+                    spec: z.ZodNullable<z.ZodString>;
+                    check: z.ZodString;
+                    layer: z.ZodString;
+                    environment: z.ZodNullable<z.ZodString>;
+                    state: z.ZodString;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
         }, z.core.$loose>;
     };
     readonly error: {

package/dist/schema/src/cli-results.js

@@ -13,7 +13,7 @@
  * @see docs/agents.md
  */
 import { z } from 'zod/v4';
-import { ReportStatusSchema } from './layer.js';
+import { RecordingReceiptSchema, ReportStatusSchema } from './layer.js';
 /** What was written for one layer by `atlas report publish`. */
 export const PublishedLayerSchema = z.looseObject({
     id: z.string().describe('The layer id: 64 hex digits, the SHA-256 of its content. Publishing the same input again gives the same id'),
@@ -26,15 +26,23 @@ export const PublishedLayerSchema = z.looseObject({
     linkedToSpec: z.number().int().nonnegative().describe('Checks that were matched to a spec file. The rest still count, but belong to no spec'),
     freshness: z.enum(['modified', 'unknown']).optional().describe('Set when the checkout had uncommitted changes (`modified`) or no git origin (`unknown`)'),
     attachmentFiles: z.number().int().nonnegative(),
-    attachmentBytes: z.number().int().nonnegative()
+    attachmentBytes: z.number().int().nonnegative(),
+    recordings: RecordingReceiptSchema.optional().describe('Present when a check declared a `recordingExpectation`: what became of each expected video, with sizes and checksums of the stored bytes. It describes publication only; the checks keep their results')
 });
 /** What `atlas report publish --format json` prints. */
 export const PublishResultSchema = z.looseObject({
-    ok: z.literal(true),
+    ok: z.boolean().describe('True when the layer was written. False only with `--require-recordings` when an expected recording is not uploaded (the layer was still written; the exit code is then 1)'),
     store: z.string().describe('Where it was written: a folder, `s3://…` or a server URL'),
     layer: PublishedLayerSchema,
     specSet: z.looseObject({ id: z.string(), files: z.number().int().nonnegative(), branch: z.string().nullable() }).optional().describe('Present when `--specs` was given'),
     run: z.looseObject({ id: z.string(), files: z.number().int().nonnegative(), bytes: z.number().int().nonnegative(), alreadyPublished: z.boolean() }).optional().describe('Present with `--upload-run`'),
+    recordings: z.looseObject({
+        strict: z.boolean().describe('Whether `--require-recordings` was given'),
+        complete: z.boolean().describe('True when every expected recording is uploaded or referenced'),
+        expected: z.number().int().nonnegative(),
+        uploaded: z.number().int().nonnegative(),
+        gaps: z.array(z.looseObject({ check: z.string(), state: z.string(), reason: z.string().optional() })).describe('Each expected recording that is skipped or unresolved. Retry after fixing it: publishing again reuses the stored files')
+    }).optional().describe('Present when a check declared a `recordingExpectation`'),
     warnings: z.array(z.string()).describe('What was skipped and why, such as an attachment file that could not be read. Never fatal')
 });
 /** What `atlas report stream --format json` prints when its input ends. */

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

@@ -15,6 +15,7 @@ export * from './spec.js';
 export * from './report-sources.js';
 export * from './layer.js';
 export * from './server-config.js';
+export * from './user-state.js';
 export * from './api.js';
 export * from './cli-results.js';
 export * from './live-run.js';

package/dist/schema/src/index.js

@@ -15,6 +15,7 @@ export * from './spec.js';
 export * from './report-sources.js';
 export * from './layer.js';
 export * from './server-config.js';
+export * from './user-state.js';
 export * from './api.js';
 export * from './cli-results.js';
 export * from './live-run.js';

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

@@ -121,6 +121,7 @@ export declare const AttachmentSchema: z.ZodObject<{
     height: z.ZodOptional<z.ZodNumber>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     description: z.ZodOptional<z.ZodString>;
+    omitted: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     at: z.ZodOptional<z.ZodObject<{
         step: z.ZodOptional<z.ZodString>;
@@ -132,6 +133,59 @@ export declare const AttachmentSchema: z.ZodObject<{
 }, z.core.$loose>;
 /** An attachment as stored in a layer, parsed from `AttachmentSchema`. */
 export type Attachment = z.output<typeof AttachmentSchema>;
+/**
+ * Whether a check is expected to have a screen recording (a video). `required`: the producer expects one, and the layer's
+ * recording receipt says whether it arrived. `not-applicable`: the check is intentionally unrecorded (an API-only check),
+ * so it counts as neither a recorded pass nor a missing video. An open string: a reader treats any other value, and its
+ * absence, as no expectation.
+ */
+export declare const RECORDING_EXPECTATIONS: readonly ["required", "not-applicable"];
+/**
+ * The state of one check's recording in a receipt, in an open vocabulary. Conventions: `uploaded` (the video's bytes are in
+ * the layer, with a checksum), `referenced` (only a `uri` was given: Atlas cannot vouch for it), `skipped` (the video was
+ * captured but its bytes were left out, with a reason), `unresolved` (no video was attached at all), `not-applicable`
+ * (intentionally unrecorded). A reader shows a state it does not know as it is and never counts it as uploaded.
+ */
+export declare const RecordingItemSchema: z.ZodObject<{
+    check: z.ZodString;
+    state: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        state: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+/**
+ * What a layer's producer published about the recordings it expected: counts and one item per check that expected a
+ * recording (or declared itself not applicable). Written by `publishChecks` when any check declares a
+ * `recordingExpectation`; a layer without it says nothing, which a reader reports as Unknown, never Complete. It only
+ * describes publication: it never changes a check's status, its slot or which result wins.
+ */
+export declare const RecordingReceiptSchema: z.ZodObject<{
+    expected: z.ZodNumber;
+    uploaded: z.ZodNumber;
+    referenced: z.ZodNumber;
+    skipped: z.ZodNumber;
+    unresolved: z.ZodNumber;
+    notApplicable: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        check: z.ZodString;
+        state: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            state: z.ZodOptional<z.ZodString>;
+            bytes: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** A recording receipt as stored in a layer, parsed from `RecordingReceiptSchema`. */
+export type RecordingReceipt = z.output<typeof RecordingReceiptSchema>;
 /** A note about a result: a warning, a deprecation, a coverage figure, an accessibility finding, anything. */
 export declare const AnnotationSchema: z.ZodObject<{
     type: z.ZodString;
@@ -182,6 +236,7 @@ export declare const StepSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -250,6 +305,7 @@ export declare const AttemptSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -295,6 +351,7 @@ export declare const AttemptSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -359,6 +416,7 @@ export declare const CheckSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -424,6 +482,7 @@ export declare const CheckSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -469,6 +528,7 @@ export declare const CheckSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -521,6 +581,7 @@ export declare const CheckSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -568,6 +629,7 @@ export declare const CheckSchema: z.ZodObject<{
         limit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$loose>>>;
     durationMs: z.ZodOptional<z.ZodNumber>;
+    recordingExpectation: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 /** A check as stored in a layer, parsed from `CheckSchema`. */
 export type Check = z.output<typeof CheckSchema>;
@@ -608,6 +670,7 @@ export declare const ReportPartSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -672,6 +735,7 @@ export declare const ReportPartSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -737,6 +801,7 @@ export declare const ReportPartSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -782,6 +847,7 @@ export declare const ReportPartSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -834,6 +900,7 @@ export declare const ReportPartSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -881,6 +948,7 @@ export declare const ReportPartSchema: z.ZodObject<{
             limit: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>>>;
         durationMs: z.ZodOptional<z.ZodNumber>;
+        recordingExpectation: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 /** A suite that recorded timelines and captured files, beside its checks. Absent for a layer of plain checks. */
@@ -923,6 +991,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -988,6 +1057,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                         height: z.ZodOptional<z.ZodNumber>;
                         durationMs: z.ZodOptional<z.ZodNumber>;
                         description: z.ZodOptional<z.ZodString>;
+                        omitted: z.ZodOptional<z.ZodString>;
                         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         at: z.ZodOptional<z.ZodObject<{
                             step: z.ZodOptional<z.ZodString>;
@@ -1033,6 +1103,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -1085,6 +1156,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -1132,6 +1204,7 @@ export declare const LayerSourceSchema: z.ZodObject<{
                 limit: z.ZodOptional<z.ZodNumber>;
             }, z.core.$loose>>>;
             durationMs: z.ZodOptional<z.ZodNumber>;
+            recordingExpectation: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
     }, z.core.$loose>>>;
     tests: z.ZodArray<z.ZodObject<{
@@ -1200,6 +1273,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -1278,6 +1352,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -1342,6 +1417,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -1407,6 +1483,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                         height: z.ZodOptional<z.ZodNumber>;
                         durationMs: z.ZodOptional<z.ZodNumber>;
                         description: z.ZodOptional<z.ZodString>;
+                        omitted: z.ZodOptional<z.ZodString>;
                         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         at: z.ZodOptional<z.ZodObject<{
                             step: z.ZodOptional<z.ZodString>;
@@ -1452,6 +1529,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -1504,6 +1582,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -1551,6 +1630,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                 limit: z.ZodOptional<z.ZodNumber>;
             }, z.core.$loose>>>;
             durationMs: z.ZodOptional<z.ZodNumber>;
+            recordingExpectation: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     source: z.ZodDefault<z.ZodNullable<z.ZodObject<{
@@ -1592,6 +1672,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                         height: z.ZodOptional<z.ZodNumber>;
                         durationMs: z.ZodOptional<z.ZodNumber>;
                         description: z.ZodOptional<z.ZodString>;
+                        omitted: z.ZodOptional<z.ZodString>;
                         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         at: z.ZodOptional<z.ZodObject<{
                             step: z.ZodOptional<z.ZodString>;
@@ -1657,6 +1738,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                             height: z.ZodOptional<z.ZodNumber>;
                             durationMs: z.ZodOptional<z.ZodNumber>;
                             description: z.ZodOptional<z.ZodString>;
+                            omitted: z.ZodOptional<z.ZodString>;
                             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                             at: z.ZodOptional<z.ZodObject<{
                                 step: z.ZodOptional<z.ZodString>;
@@ -1702,6 +1784,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                         height: z.ZodOptional<z.ZodNumber>;
                         durationMs: z.ZodOptional<z.ZodNumber>;
                         description: z.ZodOptional<z.ZodString>;
+                        omitted: z.ZodOptional<z.ZodString>;
                         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         at: z.ZodOptional<z.ZodObject<{
                             step: z.ZodOptional<z.ZodString>;
@@ -1754,6 +1837,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -1801,6 +1885,7 @@ export declare const LayerDocumentSchema: z.ZodObject<{
                     limit: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$loose>>>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
+                recordingExpectation: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>>;
         }, z.core.$loose>>>;
         tests: z.ZodArray<z.ZodObject<{
@@ -1832,6 +1917,26 @@ export declare const LayerDocumentSchema: z.ZodObject<{
             size: z.ZodNumber;
         }, z.core.$loose>>;
     }, z.core.$loose>>>;
+    recordings: z.ZodOptional<z.ZodObject<{
+        expected: z.ZodNumber;
+        uploaded: z.ZodNumber;
+        referenced: z.ZodNumber;
+        skipped: z.ZodNumber;
+        unresolved: z.ZodNumber;
+        notApplicable: z.ZodNumber;
+        items: z.ZodArray<z.ZodObject<{
+            check: z.ZodString;
+            state: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                state: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodOptional<z.ZodNumber>;
+                sha256: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 /** A layer as a reader holds it: the output of `LayerDocumentSchema`, with defaults applied. */
 export type LayerDocument = z.output<typeof LayerDocumentSchema>;
@@ -1882,6 +1987,7 @@ export declare const AttachmentInputSchema: z.ZodObject<{
     height: z.ZodOptional<z.ZodNumber>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     description: z.ZodOptional<z.ZodString>;
+    omitted: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     at: z.ZodOptional<z.ZodObject<{
         step: z.ZodOptional<z.ZodString>;
@@ -1949,6 +2055,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
             limit: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>>>;
         durationMs: z.ZodOptional<z.ZodNumber>;
+        recordingExpectation: z.ZodOptional<z.ZodString>;
         attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             name: z.ZodString;
@@ -1963,6 +2070,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
             height: z.ZodOptional<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
             description: z.ZodOptional<z.ZodString>;
+            omitted: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             at: z.ZodOptional<z.ZodObject<{
                 step: z.ZodOptional<z.ZodString>;
@@ -2019,6 +2127,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -2108,6 +2217,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
                     height: z.ZodOptional<z.ZodNumber>;
                     durationMs: z.ZodOptional<z.ZodNumber>;
                     description: z.ZodOptional<z.ZodString>;
+                    omitted: z.ZodOptional<z.ZodString>;
                     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     at: z.ZodOptional<z.ZodObject<{
                         step: z.ZodOptional<z.ZodString>;
@@ -2135,6 +2245,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
                 height: z.ZodOptional<z.ZodNumber>;
                 durationMs: z.ZodOptional<z.ZodNumber>;
                 description: z.ZodOptional<z.ZodString>;
+                omitted: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 at: z.ZodOptional<z.ZodObject<{
                     step: z.ZodOptional<z.ZodString>;
@@ -2195,6 +2306,7 @@ export declare const PublishChecksSchema: z.ZodObject<{
         height: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        omitted: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         at: z.ZodOptional<z.ZodObject<{
             step: z.ZodOptional<z.ZodString>;
@@ -2231,6 +2343,36 @@ export declare const PublishChecksSchema: z.ZodObject<{
 }, z.core.$loose>;
 /** What a caller passes to `publishChecks`: the input type of `PublishChecksSchema`, before defaults. */
 export type PublishChecksInput = z.input<typeof PublishChecksSchema>;
+/**
+ * Recording completeness across the winning results of a report: `complete` (every expected recording was published),
+ * `incomplete` (at least one is skipped or unresolved), `none-expected` (every layer declared its expectations, and none
+ * required a recording) or `unknown` (a layer has no receipt, so nothing is claimed). Independent of the checks' outcomes.
+ */
+export declare const RecordingCompletenessSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        complete: "complete";
+        incomplete: "incomplete";
+        "none-expected": "none-expected";
+    }>;
+    expected: z.ZodNumber;
+    uploaded: z.ZodNumber;
+    referenced: z.ZodNumber;
+    skipped: z.ZodNumber;
+    unresolved: z.ZodNumber;
+    notApplicable: z.ZodNumber;
+    layersWithoutReceipt: z.ZodNumber;
+    gaps: z.ZodArray<z.ZodObject<{
+        spec: z.ZodNullable<z.ZodString>;
+        check: z.ZodString;
+        layer: z.ZodString;
+        environment: z.ZodNullable<z.ZodString>;
+        state: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** A parsed `RecordingCompletenessSchema` value. */
+export type RecordingCompleteness = z.output<typeof RecordingCompletenessSchema>;
 /** The `schemaVersion` of the `ReportStatus` JSON, currently 1. */
 export declare const REPORT_STATUS_SCHEMA_VERSION = 1;
 /**
@@ -2300,6 +2442,29 @@ export declare const ReportStatusSchema: z.ZodObject<{
         runUrl: z.ZodNullable<z.ZodString>;
         detail: z.ZodString;
     }, z.core.$loose>>;
+    recordings: z.ZodOptional<z.ZodObject<{
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            complete: "complete";
+            incomplete: "incomplete";
+            "none-expected": "none-expected";
+        }>;
+        expected: z.ZodNumber;
+        uploaded: z.ZodNumber;
+        referenced: z.ZodNumber;
+        skipped: z.ZodNumber;
+        unresolved: z.ZodNumber;
+        notApplicable: z.ZodNumber;
+        layersWithoutReceipt: z.ZodNumber;
+        gaps: z.ZodArray<z.ZodObject<{
+            spec: z.ZodNullable<z.ZodString>;
+            check: z.ZodString;
+            layer: z.ZodString;
+            environment: z.ZodNullable<z.ZodString>;
+            state: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 /** A parsed `ReportStatusSchema` value. */
 export type ReportStatus = z.output<typeof ReportStatusSchema>;