@dreamboard-games/sdk 0.4.0-alpha.11 → 0.4.0-alpha.13

package/dist/testing.d.ts

@@ -5,7 +5,7 @@ import { g as ScenarioIdentity, f as PerspectiveSelector, e as InspectScenarioRe
 export { I as InspectAction, b as InspectInteraction, c as InspectInteractionInput, j as assertScenario, p as probeScenarioCommand, r as replayScenario } from './types-B-FI0jrx.js';
 import { w as wire, a as ReducerBundleContract } from './index.d-C7Ztirg6.js';
 import { R as RuntimeJson } from './runtime-json-CQ9QbLZ5.js';
-import { B, y, z as z$1, v, E } from './protocol-Bcas2Xa8.js';
+import { B, y, z as z$1, v, e, E } from './protocol-Bcas2Xa8.js';
 import { z } from 'zod';
 import { r as BrowserInteractionIntentRequest, l as BrowserInteractionEffectRequest } from './types-DJj5MJkl.js';
 import { b as PluginTransport, P as PluginRuntimeClient } from './types-CR9yEmXt.js';
@@ -646,44 +646,106 @@ interface UIParityViewport {
     readonly width: number;
     readonly height: number;
 }
-interface UIParityObservationEnvironmentV1 {
+interface UIParityObservationEnvironment {
     readonly project: string;
     readonly viewport: UIParityViewport;
 }
-interface UIParityDiagnosticV1 {
+interface UIParityDiagnostic {
     readonly code: string;
     readonly message: string;
 }
-interface UIParityObservationCheckpointV1 {
+interface UIParityObservationCheckpoint {
     readonly stepId: string;
     readonly interactionKey?: string;
     readonly interactionId?: string;
     readonly actuatorId?: string;
     readonly descriptorDigest?: string;
     readonly draftDigest?: string;
-    readonly gameVersion: number;
-    readonly actionSetVersion: string;
-    readonly perspectivePlayerId: string | null;
+    readonly basis: e;
     readonly projectionDigest: string;
     readonly semanticDigest: string;
     readonly submissionDigest?: string;
     readonly screenshot?: string;
 }
-interface UIParityObservationProvenanceV1 {
+interface UIParityObservationProvenance {
     readonly kind: "fixture-expectation" | "source-workbench" | "packed-real-host";
     readonly evidence?: string;
 }
-interface UIParityObservationV1 {
-    readonly schemaVersion: 1;
+interface UIParityObservation {
+    readonly schemaVersion: 2;
     readonly scenarioId: string;
     readonly fixtureDigest: string;
     readonly sdkCandidateDigest: string;
     readonly pluginRuntimeProtocol: 4;
     readonly browserInteractionProtocol: string;
-    readonly environment: UIParityObservationEnvironmentV1;
-    readonly provenance: UIParityObservationProvenanceV1;
-    readonly checkpoints: readonly UIParityObservationCheckpointV1[];
-    readonly diagnostics: readonly UIParityDiagnosticV1[];
+    readonly environment: UIParityObservationEnvironment;
+    readonly provenance: UIParityObservationProvenance;
+    readonly checkpoints: readonly UIParityObservationCheckpoint[];
+    readonly diagnostics: readonly UIParityDiagnostic[];
+}
+interface UIParityArtifactReference {
+    readonly path: string;
+    readonly sha256: string;
+}
+interface UIParityRunScenario {
+    readonly id: string;
+    readonly fixture: UIParityArtifactReference;
+    readonly renderModule: UIParityArtifactReference;
+    readonly expectation: UIParityArtifactReference;
+    readonly source: UIParityArtifactReference;
+}
+interface UIParityRunInput {
+    readonly schemaVersion: 2;
+    readonly sdk: {
+        readonly tarball: UIParityArtifactReference;
+    };
+    readonly referenceBundle: UIParityArtifactReference;
+    readonly fixtureBundle: {
+        readonly index: UIParityArtifactReference;
+        readonly scenarios: readonly UIParityRunScenario[];
+    };
+    readonly project: string;
+}
+interface UIParityReceiptComparison {
+    readonly scenarioId: string;
+    readonly actual: string;
+    readonly comparison: string;
+    readonly evidence?: string;
+}
+interface UIParityRealHostReceipt {
+    readonly schemaVersion: 2;
+    readonly kind: "dreamboard-ui-real-host-parity";
+    readonly mode: "real-host-parity";
+    readonly result: "passed";
+    readonly realHostExecutor: true;
+    readonly input: UIParityArtifactReference;
+    readonly sdkTarballSha256: string;
+    readonly fixtureBundleSha256: string;
+    readonly scenarios: readonly {
+        readonly id: string;
+        readonly fixtureDigest: string;
+    }[];
+    readonly source: {
+        readonly result: "passed";
+        readonly comparisons: readonly UIParityReceiptComparison[];
+    };
+    readonly internal: {
+        readonly result: "passed";
+        readonly comparisons: ReadonlyArray<{
+            readonly scenarioId: string;
+            readonly actual: string;
+            readonly expectationComparison: string;
+            readonly sourceComparison: string;
+        }>;
+    };
+    readonly project: string;
+    readonly host: {
+        readonly route: string;
+        readonly pluginIframe: true;
+        readonly pluginSessionGateway: true;
+        readonly playwright: "chromium";
+        readonly webLogPath: string;
+    };
 }
 type UIParityFailureCode = "candidate-mismatch" | "fixture-source-mismatch" | "protocol-mismatch" | "interaction-resolution-mismatch" | "preparation-mismatch" | "draft-mismatch" | "submission-mismatch" | "projection-mismatch" | "semantic-snapshot-mismatch" | "visual-mismatch" | "host-setup-failure";
 interface UIParityComparisonFailure {
@@ -704,14 +766,16 @@ type UIParityComparisonResult = {
 interface CreateUIParityObservationFromFixtureOptions {
     readonly fixture: UIScenarioFixture;
     readonly sdkCandidateDigest: string;
-    readonly environment: UIParityObservationEnvironmentV1;
+    readonly environment: UIParityObservationEnvironment;
     readonly fixtureDigest?: string;
     readonly screenshotsByStepId?: Readonly<Record<string, string>>;
-    readonly diagnostics?: readonly UIParityDiagnosticV1[];
+    readonly diagnostics?: readonly UIParityDiagnostic[];
 }
-declare function createUIParityObservationFromFixture({ fixture, sdkCandidateDigest, environment, fixtureDigest, screenshotsByStepId, diagnostics, }: CreateUIParityObservationFromFixtureOptions): UIParityObservationV1;
-declare function parseUIParityObservationV1(value: unknown): UIParityObservationV1;
-declare function compareUIParityObservations(expected: UIParityObservationV1, actual: UIParityObservationV1): UIParityComparisonResult;
+declare function createUIParityObservationFromFixture({ fixture, sdkCandidateDigest, environment, fixtureDigest, screenshotsByStepId, diagnostics, }: CreateUIParityObservationFromFixtureOptions): UIParityObservation;
+declare function parseUIParityObservation(value: unknown): UIParityObservation;
+declare function compareUIParityObservations(expected: UIParityObservation, actual: UIParityObservation): UIParityComparisonResult;
+declare function parseUIParityRunInput(value: unknown): UIParityRunInput;
+declare function parseUIParityRealHostReceipt(value: unknown): UIParityRealHostReceipt;
 
 interface FixtureHostEvent {
     readonly sequence: number;
@@ -811,4 +875,4 @@ declare function drag(options: DragReplayStepOptions): UIScenarioReplayStep;
 declare function submit(options: ReplayStepOptions): UIScenarioReplayStep;
 declare function assertStep(stepId: string, expect: UIStepExpectation): UIScenarioReplayStep;
 
-export { ActorRef, type CompilePluginProtocolTapeOptions, type CompileUIScenarioFixtureOptions, type CreateFixtureHostHarnessOptions, type CreateReducerScenarioRunnerOptions, type DeterministicIdFactory, ExpectFn, type ExploreScenarioOptions, type ExploreScenarioResult, type ExploreSeedResult, type ExploreTransitionResult, type FixtureEnvironmentInit, type FixtureHostEvent, type FixtureHostHarness, FixturePluginRuntime, FlowDiagnostic, InspectEntropy, InspectNode, type InspectScenarioOptions, InspectScenarioResult, PerspectiveRef, PerspectiveSelector, type PluginProtocolTape, type PortableSemanticReplayStep, type ProtocolUIScenarioAuthority, type ReducerScenarioBundle, type ReducerScenarioDiagnostic, type ReducerScenarioExchange, type ReducerScenarioFrame, type ReducerScenarioOperation, type ReducerScenarioRunner, type ReducerScenarioTrace, type ReducerScenarioViewer, type ReducerUIScenarioAuthority, ScenarioAssertionError, ScenarioCheckpoint, ScenarioCommand, ScenarioDispatchTraceEntry, ScenarioIdentity, ScenarioReplayDefinition, Sha256Digest, SnapshotMatcherHandler, type UIFixtureFrame, type UIFixtureProtocolStep, type UIReplayExecution, type UIReplayIdentityCandidate, type UIReplayRequest, type UIResolvedReplayIdentity, type UIScenarioAuthority, type UIScenarioAuthorityKind, type UIScenarioDefinition, type UIScenarioEnvironmentDefinition, type UIScenarioFixture, type UIScenarioFixtureBundleIndex, type UIScenarioReplayStep, type UIStepExpectation, UI_SCENARIO_FIXTURE_BUNDLE_SCHEMA_VERSION, UI_SCENARIO_FIXTURE_PLUGIN_RUNTIME_PROTOCOL, UI_SCENARIO_FIXTURE_SCHEMA_VERSION, UI_SCENARIO_FIXTURE_SUPPORTED_BROWSER_PROTOCOL_MAJOR, activate, assertDeterministicUIScenarioFixture, assertStep, assertSupportedBrowserInteractionProtocol, assertUIStepExpectationSatisfied, assertUniqueReplayIdentity, canonicalUIFixtureJson, canonicalizeUIFixtureJson, canonicalizeUIScenarioFixture, compareUIParityObservations, compilePluginProtocolTape, compileUIScenarioFixture, createDeterministicIdFactory, createExpectApi, createFixtureHostHarness, createReducerScenarioRunner, createUIParityObservationFromFixture, defaultFixtureEnvironmentInit, defineUIScenario, digestPluginProtocolTape, digestUIFixtureJson, digestUIFixtureRequest, digestUIFixtureTransportRequest, digestUIScenarioFixture, drag, exploreScenario, fill, fixtureEnvironmentInitFor, inspectScenario, isSha256Digest, parseUIParityObservationV1, parseUIScenarioFixture, parseUIScenarioFixtureBundleIndex, pluginProtocolTapeSchema, portableSemanticReplayStepSchema, press, serializeUIScenarioFixture, submit, uiFixtureFrameSchema, uiFixtureProtocolStepSchema, uiReplayExecutionSchema, uiReplayRequestSchema, uiResolvedReplayIdentitySchema, uiScenarioFixtureBundleIndexSchema, uiScenarioFixtureSchema, uiScenarioReplayStepSchema, uiStepExpectationSchema };
+export { ActorRef, type CompilePluginProtocolTapeOptions, type CompileUIScenarioFixtureOptions, type CreateFixtureHostHarnessOptions, type CreateReducerScenarioRunnerOptions, type CreateUIParityObservationFromFixtureOptions, type DeterministicIdFactory, ExpectFn, type ExploreScenarioOptions, type ExploreScenarioResult, type ExploreSeedResult, type ExploreTransitionResult, type FixtureEnvironmentInit, type FixtureHostEvent, type FixtureHostHarness, FixturePluginRuntime, FlowDiagnostic, InspectEntropy, InspectNode, type InspectScenarioOptions, InspectScenarioResult, PerspectiveRef, PerspectiveSelector, type PluginProtocolTape, type PortableSemanticReplayStep, type ProtocolUIScenarioAuthority, type ReducerScenarioBundle, type ReducerScenarioDiagnostic, type ReducerScenarioExchange, type ReducerScenarioFrame, type ReducerScenarioOperation, type ReducerScenarioRunner, type ReducerScenarioTrace, type ReducerScenarioViewer, type ReducerUIScenarioAuthority, ScenarioAssertionError, ScenarioCheckpoint, ScenarioCommand, ScenarioDispatchTraceEntry, ScenarioIdentity, ScenarioReplayDefinition, Sha256Digest, SnapshotMatcherHandler, type UIFixtureFrame, type UIFixtureProtocolStep, type UIParityArtifactReference, type UIParityComparisonFailure, type UIParityComparisonResult, type UIParityDiagnostic, type UIParityFailureCode, type UIParityObservation, type UIParityObservationCheckpoint, type UIParityObservationEnvironment, type UIParityObservationProvenance, type UIParityRealHostReceipt, type UIParityReceiptComparison, type UIParityRunInput, type UIParityRunScenario, type UIParityViewport, type UIReplayExecution, type UIReplayIdentityCandidate, type UIReplayRequest, type UIResolvedReplayIdentity, type UIScenarioAuthority, type UIScenarioAuthorityKind, type UIScenarioDefinition, type UIScenarioEnvironmentDefinition, type UIScenarioFixture, type UIScenarioFixtureBundleIndex, type UIScenarioReplayStep, type UIStepExpectation, UI_SCENARIO_FIXTURE_BUNDLE_SCHEMA_VERSION, UI_SCENARIO_FIXTURE_PLUGIN_RUNTIME_PROTOCOL, UI_SCENARIO_FIXTURE_SCHEMA_VERSION, UI_SCENARIO_FIXTURE_SUPPORTED_BROWSER_PROTOCOL_MAJOR, activate, assertDeterministicUIScenarioFixture, assertStep, assertSupportedBrowserInteractionProtocol, assertUIStepExpectationSatisfied, assertUniqueReplayIdentity, canonicalUIFixtureJson, canonicalizeUIFixtureJson, canonicalizeUIScenarioFixture, compareUIParityObservations, compilePluginProtocolTape, compileUIScenarioFixture, createDeterministicIdFactory, createExpectApi, createFixtureHostHarness, createReducerScenarioRunner, createUIParityObservationFromFixture, defaultFixtureEnvironmentInit, defineUIScenario, digestPluginProtocolTape, digestUIFixtureJson, digestUIFixtureRequest, digestUIFixtureTransportRequest, digestUIScenarioFixture, drag, exploreScenario, fill, fixtureEnvironmentInitFor, inspectScenario, isSha256Digest, parseUIParityObservation, parseUIParityRealHostReceipt, parseUIParityRunInput, parseUIScenarioFixture, parseUIScenarioFixtureBundleIndex, pluginProtocolTapeSchema, portableSemanticReplayStepSchema, press, serializeUIScenarioFixture, submit, uiFixtureFrameSchema, uiFixtureProtocolStepSchema, uiReplayExecutionSchema, uiReplayRequestSchema, uiResolvedReplayIdentitySchema, uiScenarioFixtureBundleIndexSchema, uiScenarioFixtureSchema, uiScenarioReplayStepSchema, uiStepExpectationSchema };

package/dist/testing.js

@@ -20,12 +20,12 @@ import {
   replayScenario,
   resolveScenarioCheckpoint,
   toScenarioReplayDefinition
-} from "./chunk-RU3Z5J6V.js";
-import "./chunk-5XTAQ4EQ.js";
+} from "./chunk-KZFHTUI5.js";
 import {
   StaleContractArtifactError,
   isStaleContractArtifactError
 } from "./chunk-XDGRC6OR.js";
+import "./chunk-5XTAQ4EQ.js";
 import "./chunk-YNW3KBDE.js";
 import {
   BROWSER_INTERACTION_ACTUATOR_KINDS,
@@ -872,9 +872,10 @@ var checkpointComparisons = [
   { path: "interactionId", code: "interaction-resolution-mismatch" },
   { path: "actuatorId", code: "interaction-resolution-mismatch" },
   { path: "descriptorDigest", code: "interaction-resolution-mismatch" },
-  { path: "gameVersion", code: "projection-mismatch" },
-  { path: "actionSetVersion", code: "projection-mismatch" },
-  { path: "perspectivePlayerId", code: "projection-mismatch" },
+  { path: "basis.generation", code: "projection-mismatch" },
+  { path: "basis.version", code: "projection-mismatch" },
+  { path: "basis.actionSetVersion", code: "projection-mismatch" },
+  { path: "basis.perspectivePlayerId", code: "projection-mismatch" },
   { path: "projectionDigest", code: "projection-mismatch" },
   { path: "semanticDigest", code: "semantic-snapshot-mismatch" },
   { path: "draftDigest", code: "draft-mismatch" },
@@ -923,9 +924,7 @@ function createUIParityObservationFromFixture({
       actuatorId: identity?.actuatorId,
       descriptorDigest: identity?.descriptorDigest,
       draftDigest: step.expect.draftDigest ?? identity?.draftDigest,
-      gameVersion: frame.frame.basis.version,
-      actionSetVersion: frame.frame.basis.actionSetVersion,
-      perspectivePlayerId: frame.frame.basis.perspectivePlayerId,
+      basis: frame.frame.basis,
       projectionDigest,
       semanticDigest,
       submissionDigest,
@@ -933,7 +932,7 @@ function createUIParityObservationFromFixture({
     };
   });
   return {
-    schemaVersion: 1,
+    schemaVersion: 2,
     scenarioId: fixture.id,
     fixtureDigest,
     sdkCandidateDigest,
@@ -947,10 +946,10 @@ function createUIParityObservationFromFixture({
     diagnostics
   };
 }
-function parseUIParityObservationV1(value) {
+function parseUIParityObservation(value) {
   const observation = assertRecord(value, "observation");
-  if (observation.schemaVersion !== 1) {
-    throw new Error("UI parity observation schemaVersion must be 1.");
+  if (observation.schemaVersion !== 2) {
+    throw new Error("UI parity observation schemaVersion must be 2.");
   }
   assertString(observation.scenarioId, "scenarioId");
   assertString(observation.fixtureDigest, "fixtureDigest");
@@ -977,6 +976,9 @@ function parseUIParityObservationV1(value) {
     );
   }
   assertOptionalString(provenance.evidence, "observation.provenance.evidence");
+  if (typeof provenance.evidence === "string") {
+    assertPortablePath(provenance.evidence, "observation.provenance.evidence");
+  }
   const checkpoints = assertArray(observation.checkpoints, "checkpoints");
   for (let index = 0; index < checkpoints.length; index += 1) {
     const checkpoint = assertRecord(
@@ -1004,16 +1006,7 @@ function parseUIParityObservationV1(value) {
       checkpoint.draftDigest,
       `checkpoints[${index}].draftDigest`
     );
-    assertNumber(checkpoint.gameVersion, `checkpoints[${index}].gameVersion`);
-    assertString(
-      checkpoint.actionSetVersion,
-      `checkpoints[${index}].actionSetVersion`
-    );
-    if (checkpoint.perspectivePlayerId !== null && typeof checkpoint.perspectivePlayerId !== "string") {
-      throw new Error(
-        `checkpoints[${index}].perspectivePlayerId must be a string or null.`
-      );
-    }
+    parseGameplayBasis(checkpoint.basis, `checkpoints[${index}].basis`);
     assertString(
       checkpoint.projectionDigest,
       `checkpoints[${index}].projectionDigest`
@@ -1086,6 +1079,86 @@ function compareUIParityObservations(expected, actual) {
   }
   return { ok: true };
 }
+function parseUIParityRunInput(value) {
+  const input = assertRecord(value, "input");
+  if (input.schemaVersion !== 2) {
+    throw new Error("UI parity run input schemaVersion must be 2.");
+  }
+  const sdk = assertRecord(input.sdk, "input.sdk");
+  parseArtifactReference(sdk.tarball, "input.sdk.tarball");
+  parseArtifactReference(input.referenceBundle, "input.referenceBundle");
+  const fixtureBundle = assertRecord(
+    input.fixtureBundle,
+    "input.fixtureBundle"
+  );
+  parseArtifactReference(fixtureBundle.index, "input.fixtureBundle.index");
+  const scenarios = assertArray(
+    fixtureBundle.scenarios,
+    "input.fixtureBundle.scenarios"
+  );
+  if (scenarios.length === 0) {
+    throw new Error("input.fixtureBundle.scenarios must not be empty.");
+  }
+  const ids = /* @__PURE__ */ new Set();
+  for (let index = 0; index < scenarios.length; index += 1) {
+    const path = `input.fixtureBundle.scenarios[${index}]`;
+    const scenario = assertRecord(scenarios[index], path);
+    assertString(scenario.id, `${path}.id`);
+    const id = scenario.id;
+    if (ids.has(id)) {
+      throw new Error(`${path}.id duplicates scenario '${id}'.`);
+    }
+    ids.add(id);
+    parseArtifactReference(scenario.fixture, `${path}.fixture`);
+    parseArtifactReference(scenario.renderModule, `${path}.renderModule`);
+    parseArtifactReference(scenario.expectation, `${path}.expectation`);
+    parseArtifactReference(scenario.source, `${path}.source`);
+  }
+  assertString(input.project, "input.project");
+  return input;
+}
+function parseUIParityRealHostReceipt(value) {
+  const receipt = assertRecord(value, "receipt");
+  if (receipt.schemaVersion !== 2) {
+    throw new Error("UI parity real-host receipt schemaVersion must be 2.");
+  }
+  if (receipt.kind !== "dreamboard-ui-real-host-parity" || receipt.mode !== "real-host-parity" || receipt.result !== "passed" || receipt.realHostExecutor !== true) {
+    throw new Error(
+      "UI parity real-host receipt must be a passing real-host proof."
+    );
+  }
+  parseArtifactReference(receipt.input, "receipt.input");
+  assertString(receipt.sdkTarballSha256, "receipt.sdkTarballSha256");
+  assertString(receipt.fixtureBundleSha256, "receipt.fixtureBundleSha256");
+  assertString(receipt.project, "receipt.project");
+  const scenarios = assertArray(receipt.scenarios, "receipt.scenarios");
+  if (scenarios.length === 0) {
+    throw new Error("receipt.scenarios must not be empty.");
+  }
+  for (let index = 0; index < scenarios.length; index += 1) {
+    const scenario = assertRecord(
+      scenarios[index],
+      `receipt.scenarios[${index}]`
+    );
+    assertString(scenario.id, `receipt.scenarios[${index}].id`);
+    assertString(
+      scenario.fixtureDigest,
+      `receipt.scenarios[${index}].fixtureDigest`
+    );
+  }
+  parseReceiptComparisonGroup(receipt.source, "receipt.source", false);
+  parseReceiptComparisonGroup(receipt.internal, "receipt.internal", true);
+  const host = assertRecord(receipt.host, "receipt.host");
+  assertString(host.route, "receipt.host.route");
+  assertString(host.webLogPath, "receipt.host.webLogPath");
+  assertPortablePath(host.webLogPath, "receipt.host.webLogPath");
+  if (host.pluginIframe !== true || host.pluginSessionGateway !== true || host.playwright !== "chromium") {
+    throw new Error(
+      "receipt.host must prove PluginIframe, PluginSessionGateway, and Chromium."
+    );
+  }
+  return receipt;
+}
 function comparePath(expected, actual, comparison, options = {}) {
   const expectedValue = getPath(expected, comparison.path);
   const actualValue = getPath(actual, comparison.path);
@@ -1125,6 +1198,70 @@ function getPath(value, path) {
     return current[key];
   }, value);
 }
+function parseGameplayBasis(value, path) {
+  const basis = assertRecord(value, path);
+  assertNonNegativeInteger(basis.generation, `${path}.generation`);
+  assertNonNegativeInteger(basis.version, `${path}.version`);
+  assertString(basis.actionSetVersion, `${path}.actionSetVersion`);
+  assertString(basis.perspectivePlayerId, `${path}.perspectivePlayerId`);
+  return basis;
+}
+function parseArtifactReference(value, path) {
+  const reference = assertRecord(value, path);
+  assertString(reference.path, `${path}.path`);
+  assertPortablePath(reference.path, `${path}.path`);
+  assertString(reference.sha256, `${path}.sha256`);
+  if (!reference.sha256.startsWith("sha256:")) {
+    throw new Error(`${path}.sha256 must be a sha256 digest.`);
+  }
+  return reference;
+}
+function parseReceiptComparisonGroup(value, path, internal) {
+  const group = assertRecord(value, path);
+  if (group.result !== "passed") {
+    throw new Error(`${path}.result must be passed.`);
+  }
+  const comparisons = assertArray(group.comparisons, `${path}.comparisons`);
+  for (let index = 0; index < comparisons.length; index += 1) {
+    const itemPath = `${path}.comparisons[${index}]`;
+    const comparison = assertRecord(comparisons[index], itemPath);
+    assertString(comparison.scenarioId, `${itemPath}.scenarioId`);
+    assertString(comparison.actual, `${itemPath}.actual`);
+    assertPortablePath(comparison.actual, `${itemPath}.actual`);
+    if (internal) {
+      assertString(
+        comparison.expectationComparison,
+        `${itemPath}.expectationComparison`
+      );
+      assertString(comparison.sourceComparison, `${itemPath}.sourceComparison`);
+      assertPortablePath(
+        comparison.expectationComparison,
+        `${itemPath}.expectationComparison`
+      );
+      assertPortablePath(
+        comparison.sourceComparison,
+        `${itemPath}.sourceComparison`
+      );
+    } else {
+      assertString(comparison.comparison, `${itemPath}.comparison`);
+      assertOptionalString(comparison.evidence, `${itemPath}.evidence`);
+      assertPortablePath(
+        comparison.comparison,
+        `${itemPath}.comparison`
+      );
+      if (typeof comparison.evidence === "string") {
+        assertPortablePath(comparison.evidence, `${itemPath}.evidence`);
+      }
+    }
+  }
+}
+function assertPortablePath(value, path) {
+  if (value.length === 0 || value.startsWith("/") || value.startsWith("\\") || /^[a-zA-Z]:[\\/]/.test(value) || value.split(/[\\/]+/).includes("..")) {
+    throw new Error(
+      `${path} must be a relative path within its portable bundle.`
+    );
+  }
+}
 function assertRecord(value, path) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     throw new Error(`${path} must be an object.`);
@@ -1152,6 +1289,11 @@ function assertNumber(value, path) {
     throw new Error(`${path} must be a finite number.`);
   }
 }
+function assertNonNegativeInteger(value, path) {
+  if (!Number.isInteger(value) || value < 0) {
+    throw new Error(`${path} must be a non-negative integer.`);
+  }
+}
 
 // src/testing/ui-fixture/create-fixture-host-harness.ts
 var DEFAULT_CHANNEL_ID = "fixture-channel";
@@ -1976,7 +2118,9 @@ export {
   inspectScenario,
   isSha256Digest,
   isStaleContractArtifactError,
-  parseUIParityObservationV1,
+  parseUIParityObservation,
+  parseUIParityRealHostReceipt,
+  parseUIParityRunInput,
   parseUIScenarioFixture,
   parseUIScenarioFixtureBundleIndex,
   pluginProtocolTapeSchema,