Read a bounded page of recorded run differences

Requires run.compare in this exact project. Both world-terminal reports are verified against their immutable manifests; current credential, membership, project grant, evidence availability and selection are rechecked after storage reads. Missing evidence returns 404 control.NOT_FOUND; deleted, deletion-requested, expired or changed evidence returns 409 control.CONFLICT; integrity failures return a sanitized 500 control.INTERNAL and unavailable storage a 503 control.INTERNAL. None is an empty comparison. Incompatible inputs remain explicitly marked incompatible: returned entries are descriptive only. Applied redaction also makes comparison descriptive_only with attribution disabled, even when retained input identities match. State changes align by record identity and mutation ordinal, including seed loading, not reconstructed final state or agent-only changes. Operations align by recorded call position, not inferred causal correspondence. Assertions include changed expectations even with unchanged status and actual value; checks are not re-evaluated. Values are the retained, potentially redacted JSON; each is at most 16 KiB, otherwise its exact canonical-JSON byte count and SHA-256 are returned with omitted state. Use each side’s evidenceBundleId with the existing authenticated artifact read to access the complete report. Absent means no aligned recorded entry, never an inferred record deletion. Pages contain only changed entries, at most 25 and 1 MiB. The cursor binds project, ordered run pair, manifest digests and kind; it is not authority. No model execution or mutation occurs.

Read a bounded page of recorded run differences

cURL

curl --request GET \
  --url https://api.firedrill.run/v1/projects/{projectId}/run-comparisons/details \
  --header 'Authorization: Bearer <token>'

200

{
  "schemaVersion": 1,
  "projectId": "<string>",
  "baseline": {
    "hostedRunId": "<string>",
    "evidenceBundleId": "<string>",
    "runId": "<string>",
    "manifestDigest": "<string>",
    "redaction": {
      "policy": "safe_fields_v2",
      "applied": true,
      "replacements": 0
    }
  },
  "candidate": {
    "hostedRunId": "<string>",
    "evidenceBundleId": "<string>",
    "runId": "<string>",
    "manifestDigest": "<string>",
    "redaction": {
      "policy": "safe_fields_v2",
      "applied": true,
      "replacements": 0
    }
  },
  "compatibility": {
    "status": "exact_inputs",
    "canAttributeBehaviorChange": true,
    "differences": [
      "drill"
    ],
    "explanation": "<string>"
  },
  "kind": "state_changes",
  "alignment": "<string>",
  "offset": 0,
  "total": 0,
  "items": [
    {
      "key": "<string>",
      "changedFields": [
        "<string>"
      ],
      "baseline": {
        "state": "available",
        "value": "<unknown>",
        "bytes": 8192,
        "digest": "<string>"
      },
      "candidate": {
        "state": "available",
        "value": "<unknown>",
        "bytes": 8192,
        "digest": "<string>"
      },
      "kind": "state_changes",
      "identity": {
        "packageId": "<string>",
        "namespace": "<string>",
        "rowId": "<string>",
        "mutation": 4503599627370495
      }
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

Authorization · string · header · required

Opaque control credential

Path Parameters

projectId · string · required

Pattern: ^prj_[0-9a-z]{12,32}$

Query Parameters

baselineHostedRunId · string · required

Pattern: ^hrun_[0-9a-z]{12,32}$

candidateHostedRunId · string · required

Pattern: ^hrun_[0-9a-z]{12,32}$

kind · enum<string> · required

Available options: state_changes, operations, assertions

cursor · string

Required string length: 1 - 4096

limit · integer · default: 10

Required range: 1 <= x <= 25

Response

200

application/json

Bounded recorded differences

schemaVersion · enum<number> · required

Available options: 1

projectId · string · required

Pattern: ^prj_[0-9a-z]{12,32}$

baseline · object · required

Show child attributes

candidate · object · required

Show child attributes

compatibility · object · required

Show child attributes

kind · enum<string> · required

Available options: state_changes, operations, assertions

alignment · string · required

Required string length: 1 - 2000

offset · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

total · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

items · object[] · required

Maximum array length: 25

Option 1

Option 2

Option 3

Show child attributes

nextCursor · string

Required string length: 1 - 4096