@inflexa-ai/harness 0.45.0 → 0.46.0

package/dist/contracts/report-reference.d.ts

@@ -15,8 +15,13 @@ import { z } from "zod";
  * thus it carries the value assert.
  */
 export declare const ArtifactValueReferenceSchema: z.ZodObject<{
+    run: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    hash: z.ZodString;
+    snapshot: z.ZodOptional<z.ZodString>;
     unit: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"artifact-value">;
     locator: z.ZodObject<{
         column: z.ZodString;
         rowFilter: z.ZodOptional<z.ZodObject<{
@@ -30,11 +35,6 @@ export declare const ArtifactValueReferenceSchema: z.ZodObject<{
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         tolerance: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
-    run: z.ZodOptional<z.ZodString>;
-    path: z.ZodString;
-    hash: z.ZodString;
-    snapshot: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"artifact-value">;
 }, z.core.$strict>;
 /**
  * What one column of a table holds, as a closed set of five.
@@ -43,11 +43,11 @@ export declare const ArtifactValueReferenceSchema: z.ZodObject<{
  * how each meaning reads on the page, thus no block carries a format field.
  */
 export declare const ColumnMeaningSchema: z.ZodEnum<{
+    category: "category";
     count: "count";
+    effect: "effect";
     identifier: "identifier";
-    category: "category";
     "p-value": "p-value";
-    effect: "effect";
 }>;
 /**
  * The row bound of a whole-table binding: the top rows by one column.
@@ -73,8 +73,13 @@ export declare const RowBoundSchema: z.ZodObject<{
  * binding, thus one declaration serves the table block and the chart block alike.
  */
 export declare const ArtifactTableReferenceSchema: z.ZodObject<{
+    run: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    hash: z.ZodString;
+    snapshot: z.ZodOptional<z.ZodString>;
     unit: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"artifact-table">;
     rowBound: z.ZodOptional<z.ZodObject<{
         column: z.ZodString;
         count: z.ZodNumber;
@@ -85,18 +90,13 @@ export declare const ArtifactTableReferenceSchema: z.ZodObject<{
     }, z.core.$strict>>;
     columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
     columnMeanings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        category: "category";
         count: "count";
+        effect: "effect";
         identifier: "identifier";
-        category: "category";
         "p-value": "p-value";
-        effect: "effect";
     }>>>;
     columnLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    run: z.ZodOptional<z.ZodString>;
-    path: z.ZodString;
-    hash: z.ZodString;
-    snapshot: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"artifact-table">;
 }, z.core.$strict>;
 /**
  * A reference to a whole artifact file, for example an image. It carries no locator and no columns,
@@ -104,12 +104,12 @@ export declare const ArtifactTableReferenceSchema: z.ZodObject<{
  * same reason as a table reference.
  */
 export declare const ArtifactFileReferenceSchema: z.ZodObject<{
-    unit: z.ZodOptional<z.ZodString>;
-    format: z.ZodOptional<z.ZodString>;
     run: z.ZodOptional<z.ZodString>;
     path: z.ZodString;
     hash: z.ZodString;
     snapshot: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodString>;
     kind: z.ZodLiteral<"artifact-file">;
 }, z.core.$strict>;
 /**
@@ -121,9 +121,9 @@ export declare const CitationReferenceSchema: z.ZodObject<{
     format: z.ZodOptional<z.ZodString>;
     kind: z.ZodLiteral<"citation">;
     idKind: z.ZodEnum<{
+        arxiv: "arxiv";
         doi: "doi";
         pmid: "pmid";
-        arxiv: "arxiv";
     }>;
     id: z.ZodString;
     raw: z.ZodString;
@@ -140,8 +140,13 @@ export declare const CitationReferenceSchema: z.ZodObject<{
  * derivation is out of the set too, thus a derivation over a derivation stays unrepresentable.
  */
 export declare const DerivationInputReferenceSchema: z.ZodObject<{
+    run: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    hash: z.ZodString;
+    snapshot: z.ZodOptional<z.ZodString>;
     unit: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"artifact-value">;
     locator: z.ZodObject<{
         column: z.ZodString;
         rowFilter: z.ZodOptional<z.ZodObject<{
@@ -155,11 +160,6 @@ export declare const DerivationInputReferenceSchema: z.ZodObject<{
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         tolerance: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
-    run: z.ZodOptional<z.ZodString>;
-    path: z.ZodString;
-    hash: z.ZodString;
-    snapshot: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"artifact-value">;
 }, z.core.$strict>;
 /**
  * A reference to a value computed from other references. Each of the three operations takes two inputs,
@@ -171,13 +171,18 @@ export declare const DerivationReferenceSchema: z.ZodObject<{
     format: z.ZodOptional<z.ZodString>;
     kind: z.ZodLiteral<"derivation">;
     op: z.ZodEnum<{
-        ratio: "ratio";
         delta: "delta";
         pctChange: "pctChange";
+        ratio: "ratio";
     }>;
     inputs: z.ZodArray<z.ZodObject<{
+        run: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        hash: z.ZodString;
+        snapshot: z.ZodOptional<z.ZodString>;
         unit: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"artifact-value">;
         locator: z.ZodObject<{
             column: z.ZodString;
             rowFilter: z.ZodOptional<z.ZodObject<{
@@ -191,11 +196,6 @@ export declare const DerivationReferenceSchema: z.ZodObject<{
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
             tolerance: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
-        run: z.ZodOptional<z.ZodString>;
-        path: z.ZodString;
-        hash: z.ZodString;
-        snapshot: z.ZodOptional<z.ZodString>;
-        kind: z.ZodLiteral<"artifact-value">;
     }, z.core.$strict>>;
     assert: z.ZodOptional<z.ZodObject<{
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
@@ -204,8 +204,13 @@ export declare const DerivationReferenceSchema: z.ZodObject<{
 }, z.core.$strict>;
 /** The full reference union. A block binds to one of these. */
 export declare const ReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    run: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    hash: z.ZodString;
+    snapshot: z.ZodOptional<z.ZodString>;
     unit: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"artifact-value">;
     locator: z.ZodObject<{
         column: z.ZodString;
         rowFilter: z.ZodOptional<z.ZodObject<{
@@ -219,14 +224,14 @@ export declare const ReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         tolerance: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
     run: z.ZodOptional<z.ZodString>;
     path: z.ZodString;
     hash: z.ZodString;
     snapshot: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"artifact-value">;
-}, z.core.$strict>, z.ZodObject<{
     unit: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"artifact-table">;
     rowBound: z.ZodOptional<z.ZodObject<{
         column: z.ZodString;
         count: z.ZodNumber;
@@ -237,38 +242,38 @@ export declare const ReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strict>>;
     columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
     columnMeanings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        category: "category";
         count: "count";
+        effect: "effect";
         identifier: "identifier";
-        category: "category";
         "p-value": "p-value";
-        effect: "effect";
     }>>>;
     columnLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
     run: z.ZodOptional<z.ZodString>;
     path: z.ZodString;
     hash: z.ZodString;
     snapshot: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"artifact-table">;
-}, z.core.$strict>, z.ZodObject<{
     unit: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
-    run: z.ZodOptional<z.ZodString>;
-    path: z.ZodString;
-    hash: z.ZodString;
-    snapshot: z.ZodOptional<z.ZodString>;
     kind: z.ZodLiteral<"artifact-file">;
 }, z.core.$strict>, z.ZodObject<{
     unit: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
     kind: z.ZodLiteral<"derivation">;
     op: z.ZodEnum<{
-        ratio: "ratio";
         delta: "delta";
         pctChange: "pctChange";
+        ratio: "ratio";
     }>;
     inputs: z.ZodArray<z.ZodObject<{
+        run: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        hash: z.ZodString;
+        snapshot: z.ZodOptional<z.ZodString>;
         unit: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"artifact-value">;
         locator: z.ZodObject<{
             column: z.ZodString;
             rowFilter: z.ZodOptional<z.ZodObject<{
@@ -282,11 +287,6 @@ export declare const ReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
             tolerance: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
-        run: z.ZodOptional<z.ZodString>;
-        path: z.ZodString;
-        hash: z.ZodString;
-        snapshot: z.ZodOptional<z.ZodString>;
-        kind: z.ZodLiteral<"artifact-value">;
     }, z.core.$strict>>;
     assert: z.ZodOptional<z.ZodObject<{
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
@@ -297,9 +297,9 @@ export declare const ReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     format: z.ZodOptional<z.ZodString>;
     kind: z.ZodLiteral<"citation">;
     idKind: z.ZodEnum<{
+        arxiv: "arxiv";
         doi: "doi";
         pmid: "pmid";
-        arxiv: "arxiv";
     }>;
     id: z.ZodString;
     raw: z.ZodString;
@@ -312,8 +312,13 @@ export declare const ReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
  * numeric literal can sit in the slot: the type admits a reference only.
  */
 export declare const ScalarReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    run: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    hash: z.ZodString;
+    snapshot: z.ZodOptional<z.ZodString>;
     unit: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"artifact-value">;
     locator: z.ZodObject<{
         column: z.ZodString;
         rowFilter: z.ZodOptional<z.ZodObject<{
@@ -327,23 +332,23 @@ export declare const ScalarReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         tolerance: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
-    run: z.ZodOptional<z.ZodString>;
-    path: z.ZodString;
-    hash: z.ZodString;
-    snapshot: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"artifact-value">;
 }, z.core.$strict>, z.ZodObject<{
     unit: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
     kind: z.ZodLiteral<"derivation">;
     op: z.ZodEnum<{
-        ratio: "ratio";
         delta: "delta";
         pctChange: "pctChange";
+        ratio: "ratio";
     }>;
     inputs: z.ZodArray<z.ZodObject<{
+        run: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        hash: z.ZodString;
+        snapshot: z.ZodOptional<z.ZodString>;
         unit: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"artifact-value">;
         locator: z.ZodObject<{
             column: z.ZodString;
             rowFilter: z.ZodOptional<z.ZodObject<{
@@ -357,11 +362,6 @@ export declare const ScalarReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
             tolerance: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
-        run: z.ZodOptional<z.ZodString>;
-        path: z.ZodString;
-        hash: z.ZodString;
-        snapshot: z.ZodOptional<z.ZodString>;
-        kind: z.ZodLiteral<"artifact-value">;
     }, z.core.$strict>>;
     assert: z.ZodOptional<z.ZodObject<{
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
@@ -379,19 +379,40 @@ export declare const ScalarReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject
  * `extraction-unavailable` means that the value tier must use an extraction arm that is not wired.
  */
 export declare const UnresolvedReasonSchema: z.ZodEnum<{
+    "ambiguous-match": "ambiguous-match";
     "artifact-missing": "artifact-missing";
+    "assertion-failed": "assertion-failed";
+    "extraction-unavailable": "extraction-unavailable";
     "hash-mismatch": "hash-mismatch";
     "locator-out-of-range": "locator-out-of-range";
-    "ambiguous-match": "ambiguous-match";
-    "assertion-failed": "assertion-failed";
     "unreadable-artifact": "unreadable-artifact";
-    "extraction-unavailable": "extraction-unavailable";
 }>;
+/**
+ * The reference of a refusal.
+ *
+ * The validate, finish, and resolver paths refuse a reference that parsed, so it rides as a `Reference`.
+ * The hash stamp runs before the parse, so its refusal carries the object as the author wrote it: a pinned
+ * kind and a path, with every other field unvalidated author text. One type carries both, and no consumer
+ * re-derives which arm a refusal holds.
+ */
+export declare const AuthoredPinRecordSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        "artifact-file": "artifact-file";
+        "artifact-table": "artifact-table";
+        "artifact-value": "artifact-value";
+    }>;
+    path: z.ZodString;
+}, z.core.$loose>;
 /** A reference that resolution could not bind, with the reason and an optional detail. */
 export declare const UnresolvedReferenceSchema: z.ZodObject<{
-    reference: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    reference: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        run: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        hash: z.ZodString;
+        snapshot: z.ZodOptional<z.ZodString>;
         unit: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"artifact-value">;
         locator: z.ZodObject<{
             column: z.ZodString;
             rowFilter: z.ZodOptional<z.ZodObject<{
@@ -405,14 +426,14 @@ export declare const UnresolvedReferenceSchema: z.ZodObject<{
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
             tolerance: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
         run: z.ZodOptional<z.ZodString>;
         path: z.ZodString;
         hash: z.ZodString;
         snapshot: z.ZodOptional<z.ZodString>;
-        kind: z.ZodLiteral<"artifact-value">;
-    }, z.core.$strict>, z.ZodObject<{
         unit: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"artifact-table">;
         rowBound: z.ZodOptional<z.ZodObject<{
             column: z.ZodString;
             count: z.ZodNumber;
@@ -423,38 +444,38 @@ export declare const UnresolvedReferenceSchema: z.ZodObject<{
         }, z.core.$strict>>;
         columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
         columnMeanings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+            category: "category";
             count: "count";
+            effect: "effect";
             identifier: "identifier";
-            category: "category";
             "p-value": "p-value";
-            effect: "effect";
         }>>>;
         columnLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
         run: z.ZodOptional<z.ZodString>;
         path: z.ZodString;
         hash: z.ZodString;
         snapshot: z.ZodOptional<z.ZodString>;
-        kind: z.ZodLiteral<"artifact-table">;
-    }, z.core.$strict>, z.ZodObject<{
         unit: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
-        run: z.ZodOptional<z.ZodString>;
-        path: z.ZodString;
-        hash: z.ZodString;
-        snapshot: z.ZodOptional<z.ZodString>;
         kind: z.ZodLiteral<"artifact-file">;
     }, z.core.$strict>, z.ZodObject<{
         unit: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
         kind: z.ZodLiteral<"derivation">;
         op: z.ZodEnum<{
-            ratio: "ratio";
             delta: "delta";
             pctChange: "pctChange";
+            ratio: "ratio";
         }>;
         inputs: z.ZodArray<z.ZodObject<{
+            run: z.ZodOptional<z.ZodString>;
+            path: z.ZodString;
+            hash: z.ZodString;
+            snapshot: z.ZodOptional<z.ZodString>;
             unit: z.ZodOptional<z.ZodString>;
             format: z.ZodOptional<z.ZodString>;
+            kind: z.ZodLiteral<"artifact-value">;
             locator: z.ZodObject<{
                 column: z.ZodString;
                 rowFilter: z.ZodOptional<z.ZodObject<{
@@ -468,11 +489,6 @@ export declare const UnresolvedReferenceSchema: z.ZodObject<{
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
                 tolerance: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strict>>;
-            run: z.ZodOptional<z.ZodString>;
-            path: z.ZodString;
-            hash: z.ZodString;
-            snapshot: z.ZodOptional<z.ZodString>;
-            kind: z.ZodLiteral<"artifact-value">;
         }, z.core.$strict>>;
         assert: z.ZodOptional<z.ZodObject<{
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
@@ -483,24 +499,31 @@ export declare const UnresolvedReferenceSchema: z.ZodObject<{
         format: z.ZodOptional<z.ZodString>;
         kind: z.ZodLiteral<"citation">;
         idKind: z.ZodEnum<{
+            arxiv: "arxiv";
             doi: "doi";
             pmid: "pmid";
-            arxiv: "arxiv";
         }>;
         id: z.ZodString;
         raw: z.ZodString;
         assert: z.ZodOptional<z.ZodObject<{
             value: z.ZodString;
         }, z.core.$strict>>;
-    }, z.core.$strict>], "kind">;
+    }, z.core.$strict>], "kind">, z.ZodObject<{
+        kind: z.ZodEnum<{
+            "artifact-file": "artifact-file";
+            "artifact-table": "artifact-table";
+            "artifact-value": "artifact-value";
+        }>;
+        path: z.ZodString;
+    }, z.core.$loose>]>;
     reason: z.ZodEnum<{
+        "ambiguous-match": "ambiguous-match";
         "artifact-missing": "artifact-missing";
+        "assertion-failed": "assertion-failed";
+        "extraction-unavailable": "extraction-unavailable";
         "hash-mismatch": "hash-mismatch";
         "locator-out-of-range": "locator-out-of-range";
-        "ambiguous-match": "ambiguous-match";
-        "assertion-failed": "assertion-failed";
         "unreadable-artifact": "unreadable-artifact";
-        "extraction-unavailable": "extraction-unavailable";
     }>;
     detail: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
@@ -515,6 +538,7 @@ export type DerivationReference = z.infer<typeof DerivationReferenceSchema>;
 export type Reference = z.infer<typeof ReferenceSchema>;
 export type ScalarReference = z.infer<typeof ScalarReferenceSchema>;
 export type UnresolvedReason = z.infer<typeof UnresolvedReasonSchema>;
+export type AuthoredPinRecord = z.infer<typeof AuthoredPinRecordSchema>;
 export type UnresolvedReference = z.infer<typeof UnresolvedReferenceSchema>;
 /**
  * The declaration that a binding holds for one column, or `undefined` when it holds none.

package/dist/contracts/report-reference.js

@@ -16,6 +16,7 @@ import { z } from "zod";
  * lowercase only. Thus the pattern rejects an uppercase hex digit, which would pass a case-insensitive
  * match here but never resolve against the lowercase producer.
  */
+// oxlint-disable-next-line eslint-js/no-restricted-syntax -- the hash shape is algorithm:hex with lowercase hex only; the case rule is what makes the exact equality comparison resolve.
 const HASH_PATTERN = /^[a-z0-9]+:[0-9a-f]+$/;
 /**
  * The pin that ties an artifact reference to one immutable file. It names the analysis-relative path and
@@ -222,9 +223,21 @@ export const UnresolvedReasonSchema = z.enum([
     "unreadable-artifact",
     "extraction-unavailable",
 ]);
+/**
+ * The reference of a refusal.
+ *
+ * The validate, finish, and resolver paths refuse a reference that parsed, so it rides as a `Reference`.
+ * The hash stamp runs before the parse, so its refusal carries the object as the author wrote it: a pinned
+ * kind and a path, with every other field unvalidated author text. One type carries both, and no consumer
+ * re-derives which arm a refusal holds.
+ */
+export const AuthoredPinRecordSchema = z.looseObject({
+    kind: z.enum(["artifact-value", "artifact-table", "artifact-file"]),
+    path: z.string(),
+});
 /** A reference that resolution could not bind, with the reason and an optional detail. */
 export const UnresolvedReferenceSchema = z.strictObject({
-    reference: ReferenceSchema,
+    reference: z.union([ReferenceSchema, AuthoredPinRecordSchema]),
     reason: UnresolvedReasonSchema,
     detail: z.string().optional(),
 });
@@ -249,7 +262,10 @@ const REFERENCE_URI_PREFIX = "inflexa-ref:v1:";
  * Thus a corrupt payload would otherwise decode to mojibake and report as malformed JSON, which names
  * the wrong failure.
  */
+// oxlint-disable-next-line eslint-js/no-restricted-syntax -- the base64url alphabet check; Buffer.from never throws, so this explicit shape check is the only malformed-payload guard.
 const BASE64URL_PATTERN = /^[A-Za-z0-9_-]+$/;
+/** The module imports no value from outside `contracts/`, so the generic record schema lives here. */
+const UnknownRecordSchema = z.record(z.string(), z.unknown());
 /**
  * Sort the keys of every object so that serialization is deterministic. An array keeps its order,
  * because the order of a derivation's inputs carries meaning.
@@ -258,14 +274,15 @@ function sortKeysDeep(value) {
     if (Array.isArray(value)) {
         return value.map(sortKeysDeep);
     }
-    if (value !== null && typeof value === "object") {
-        const sorted = {};
-        for (const key of Object.keys(value).sort()) {
-            sorted[key] = sortKeysDeep(value[key]);
-        }
-        return sorted;
+    const parsedRecord = UnknownRecordSchema.safeParse(value);
+    if (!parsedRecord.success)
+        return value;
+    const record = parsedRecord.data;
+    const sorted = {};
+    for (const key of Object.keys(record).sort()) {
+        sorted[key] = sortKeysDeep(record[key]);
     }
-    return value;
+    return sorted;
 }
 /**
  * Serialize a reference to a canonical URI.
@@ -294,14 +311,14 @@ export function parseReference(uri) {
         return err({ kind: "invalid-payload" });
     }
     const json = Buffer.from(payload, "base64url").toString("utf8");
-    let candidate;
+    let decoded;
     try {
-        candidate = JSON.parse(json);
+        // oxlint-disable-next-line eslint-js/no-restricted-syntax -- contracts/ imports no value from lib/, and ReferenceSchema checks the result on the next line.
+        decoded = JSON.parse(json);
     }
     catch {
-        // `JSON.parse` throws on malformed input. The boundary turns the throw into an `Err`.
         return err({ kind: "invalid-json" });
     }
-    const result = ReferenceSchema.safeParse(candidate);
-    return result.success ? ok(result.data) : err({ kind: "schema-mismatch" });
+    const parsed = ReferenceSchema.safeParse(decoded);
+    return parsed.success ? ok(parsed.data) : err({ kind: "schema-mismatch" });
 }

package/dist/contracts/schemas/chat-events.d.ts

@@ -26,16 +26,16 @@ export declare const IterationEventSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** Mirrors the `ToolOutcome` union — three states, never a boolean. */
 export declare const ToolOutcomeSchema: z.ZodEnum<{
+    denied: "denied";
     error: "error";
     ok: "ok";
-    denied: "denied";
 }>;
 /** Mirrors `ToolCallOutcome` — the live three plus the record-only `incomplete`. */
 export declare const ToolCallOutcomeSchema: z.ZodEnum<{
-    error: "error";
-    ok: "ok";
     denied: "denied";
+    error: "error";
     incomplete: "incomplete";
+    ok: "ok";
 }>;
 export declare const ToolStartedEventSchema: z.ZodObject<{
     type: z.ZodLiteral<"tool-started">;
@@ -53,9 +53,9 @@ export declare const ToolFinishedEventSchema: z.ZodObject<{
     toolUseId: z.ZodString;
     name: z.ZodString;
     outcome: z.ZodEnum<{
+        denied: "denied";
         error: "error";
         ok: "ok";
-        denied: "denied";
     }>;
     detail: z.ZodOptional<z.ZodString>;
     durationMs: z.ZodOptional<z.ZodNumber>;
@@ -97,6 +97,26 @@ export declare const ChatErrorEventSchema: z.ZodObject<{
         invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const MessageStartEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"message-start">;
+    messageId: z.ZodUUID;
+    role: z.ZodLiteral<"user">;
+    text: z.ZodString;
+    source: z.ZodObject<{
+        agentId: z.ZodString;
+        callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message-start">;
+    messageId: z.ZodUUID;
+    role: z.ZodLiteral<"assistant">;
+    source: z.ZodObject<{
+        agentId: z.ZodString;
+        callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "role">;
 export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"text-delta">;
     text: z.ZodString;
@@ -127,9 +147,9 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     toolUseId: z.ZodString;
     name: z.ZodString;
     outcome: z.ZodEnum<{
+        denied: "denied";
         error: "error";
         ok: "ok";
-        denied: "denied";
     }>;
     detail: z.ZodOptional<z.ZodString>;
     durationMs: z.ZodOptional<z.ZodNumber>;
@@ -168,4 +188,23 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         callPath: z.ZodArray<z.ZodString>;
         invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-}, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"message-start">;
+    messageId: z.ZodUUID;
+    role: z.ZodLiteral<"user">;
+    text: z.ZodString;
+    source: z.ZodObject<{
+        agentId: z.ZodString;
+        callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message-start">;
+    messageId: z.ZodUUID;
+    role: z.ZodLiteral<"assistant">;
+    source: z.ZodObject<{
+        agentId: z.ZodString;
+        callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "role">], "type">;

package/dist/contracts/schemas/chat-events.js

@@ -50,6 +50,21 @@ export const ChatErrorEventSchema = z.object({
     reason: z.string().optional(),
     source: EventSourceSchema,
 });
+export const MessageStartEventSchema = z.discriminatedUnion("role", [
+    z.object({
+        type: z.literal("message-start"),
+        messageId: z.uuid(),
+        role: z.literal("user"),
+        text: z.string(),
+        source: EventSourceSchema,
+    }),
+    z.object({
+        type: z.literal("message-start"),
+        messageId: z.uuid(),
+        role: z.literal("assistant"),
+        source: EventSourceSchema,
+    }),
+]);
 export const ChatEventSchema = z.discriminatedUnion("type", [
     TextDeltaEventSchema,
     IterationEventSchema,
@@ -57,4 +72,5 @@ export const ChatEventSchema = z.discriminatedUnion("type", [
     ToolFinishedEventSchema,
     FinishEventSchema,
     ChatErrorEventSchema,
+    MessageStartEventSchema,
 ]);