agent-hitch 0.2.6 → 0.2.8

package/docs/schemas/trajectory-analysis.schema.json

@@ -0,0 +1,258 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/trajectory-analysis.schema.json",
+  "title": "Hitch bounded trajectory analysis",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "run_id", "source", "header", "surface", "events", "chunk_summaries", "omitted_event_types", "coverage"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "kind": { "const": "trajectory-analysis" },
+    "run_id": { "$ref": "#/$defs/run_id" },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fidelity", "session_id", "canonical_sha256", "canonical_bytes", "event_count", "event_types"],
+      "properties": {
+        "fidelity": { "enum": ["provider_native", "normalized", "minimal"] },
+        "provider": { "type": "string", "minLength": 1 },
+        "session_id": { "type": "string", "minLength": 1 },
+        "canonical_sha256": { "$ref": "#/$defs/sha256" },
+        "canonical_bytes": { "type": "integer", "minimum": 0 },
+        "event_count": { "type": "integer", "minimum": 0 },
+        "event_types": { "$ref": "#/$defs/counts" }
+      }
+    },
+    "header": true,
+    "surface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fidelity", "nodes", "current_node_seqs", "replacements", "request_boundaries", "request_headers"],
+      "properties": {
+        "fidelity": { "enum": ["exact", "normalized", "partial"] },
+        "nodes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["seq", "event_type", "surface_op", "message"],
+            "properties": {
+              "seq": { "$ref": "#/$defs/seq" },
+              "event_type": { "enum": ["user/message", "assistant/message", "tool/result"] },
+              "surface_op": { "$ref": "#/$defs/surface_op" },
+              "message": true
+            }
+          }
+        },
+        "current_node_seqs": { "type": "array", "items": { "$ref": "#/$defs/seq" } },
+        "replacements": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["seq", "start", "end", "shadowed_seqs"],
+            "properties": {
+              "seq": { "$ref": "#/$defs/seq" },
+              "start": { "$ref": "#/$defs/seq" },
+              "end": { "$ref": "#/$defs/seq" },
+              "shadowed_seqs": { "type": "array", "items": { "$ref": "#/$defs/seq" } }
+            }
+          }
+        },
+        "request_boundaries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["turn", "step", "attempt", "boundary_seq", "surface_revision"],
+            "properties": {
+              "turn": { "$ref": "#/$defs/seq" },
+              "step": { "$ref": "#/$defs/seq" },
+              "attempt": { "$ref": "#/$defs/seq" },
+              "retry_id": { "$ref": "#/$defs/projected_string" },
+              "boundary_seq": { "$ref": "#/$defs/seq" },
+              "surface_revision": { "$ref": "#/$defs/seq" },
+              "request_header_seq": { "$ref": "#/$defs/seq" }
+            }
+          }
+        },
+        "request_headers": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["seq", "header"],
+            "properties": {
+              "seq": { "$ref": "#/$defs/seq" },
+              "header": true
+            }
+          }
+        }
+      }
+    },
+    "events": { "type": "array", "items": { "$ref": "#/$defs/diagnostic_event" } },
+    "chunk_summaries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["turn", "step", "attempt", "first_seq", "last_seq", "count", "types", "model_boundary_seq"],
+        "properties": {
+          "turn": { "$ref": "#/$defs/seq" },
+          "step": { "$ref": "#/$defs/seq" },
+          "attempt": { "$ref": "#/$defs/seq" },
+          "retry_id": { "$ref": "#/$defs/projected_string" },
+          "first_seq": { "$ref": "#/$defs/seq" },
+          "last_seq": { "$ref": "#/$defs/seq" },
+          "count": { "type": "integer", "minimum": 1 },
+          "types": { "$ref": "#/$defs/counts" },
+          "model_boundary_seq": { "$ref": "#/$defs/seq" },
+          "usage": true,
+          "finish_reason": true,
+          "partial": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["status", "source_seq_count"],
+            "oneOf": [
+              { "required": ["content"] },
+              { "required": ["streams"] }
+            ],
+            "properties": {
+              "status": { "const": "incomplete" },
+              "content": { "$ref": "#/$defs/content_excerpt" },
+              "streams": {
+                "type": "array",
+                "minItems": 2,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["block_index", "block_start_seq", "kind", "content", "source_seq_count"],
+                  "properties": {
+                    "block_index": { "$ref": "#/$defs/seq" },
+                    "block_start_seq": { "$ref": "#/$defs/seq" },
+                    "kind": { "enum": ["text", "reasoning", "tool_arguments"] },
+                    "content": { "$ref": "#/$defs/content_excerpt" },
+                    "source_seq_count": { "type": "integer", "minimum": 0 }
+                  }
+                }
+              },
+              "source_seq_count": { "type": "integer", "minimum": 0 }
+            }
+          }
+        }
+      }
+    },
+    "omitted_event_types": { "$ref": "#/$defs/counts" },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["surface", "chunks", "content", "child_sessions"],
+      "properties": {
+        "surface": { "enum": ["complete", "partial"] },
+        "chunks": { "enum": ["coalesced", "omitted", "partial"] },
+        "content": { "enum": ["complete", "excerpted", "partial"] },
+        "child_sessions": { "enum": ["complete", "partial", "none", "unavailable"] }
+      }
+    },
+    "redactions": { "$ref": "#/$defs/redactions" }
+  },
+  "$defs": {
+    "run_id": { "type": "string", "pattern": "^run_[a-f0-9]{32}$" },
+    "sha256": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "seq": { "type": "integer", "minimum": 0 },
+    "surface_op": {
+      "oneOf": [
+        { "const": "append" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["op", "start", "end"],
+          "properties": {
+            "op": { "const": "replace" },
+            "start": { "$ref": "#/$defs/seq" },
+            "end": { "$ref": "#/$defs/seq" }
+          }
+        }
+      ]
+    },
+    "counts": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } },
+    "projected_string": {
+      "oneOf": [
+        { "type": "string" },
+        { "$ref": "#/$defs/content_excerpt" }
+      ]
+    },
+    "diagnostic_event": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "seq", "time", "data"],
+          "properties": {
+            "type": { "type": "string", "minLength": 1, "maxLength": 1024 },
+            "seq": { "$ref": "#/$defs/seq" },
+            "time": { "type": "number" },
+            "data": true,
+            "ignorable": { "const": true },
+            "surfaceOp": { "$ref": "#/$defs/surface_op" },
+            "source_event_seqs_summary": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["count"],
+              "properties": {
+                "count": { "type": "integer", "minimum": 0 },
+                "first": { "$ref": "#/$defs/seq" },
+                "last": { "$ref": "#/$defs/seq" }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "seq", "time", "event_excerpt"],
+          "properties": {
+            "type": { "type": "string", "minLength": 1, "maxLength": 1024 },
+            "seq": { "$ref": "#/$defs/seq" },
+            "time": { "type": "number" },
+            "event_excerpt": { "$ref": "#/$defs/content_excerpt" }
+          }
+        }
+      ]
+    },
+    "content_excerpt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["preview", "bytes", "sha256", "truncated", "source"],
+      "properties": {
+        "preview": { "type": "string" },
+        "tail": { "type": "string" },
+        "bytes": { "type": "integer", "minimum": 0 },
+        "sha256": { "$ref": "#/$defs/sha256" },
+        "truncated": { "type": "boolean" },
+        "source": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["run_id", "seq", "field"],
+          "properties": {
+            "run_id": { "$ref": "#/$defs/run_id" },
+            "seq": { "$ref": "#/$defs/seq" },
+            "field": { "type": "string", "minLength": 1, "maxLength": 1024 }
+          }
+        }
+      }
+    },
+    "redactions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["rule_id", "count"],
+        "properties": {
+          "rule_id": { "type": "string", "minLength": 1 },
+          "count": { "type": "integer", "minimum": 1 }
+        }
+      }
+    }
+  }
+}

package/docs/schemas/trajectory-events-page.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-hitch.local/schemas/trajectory-events-page.schema.json",
+  "title": "Hitch source-filtered trajectory event page",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "run_id", "canonical_sha256", "filter", "events", "total_matches", "eof"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "kind": { "const": "trajectory-events-page" },
+    "run_id": { "type": "string", "pattern": "^run_[a-f0-9]{32}$" },
+    "canonical_sha256": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "filter": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "types": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+        "seq_start": { "type": "integer", "minimum": 0 },
+        "seq_end": { "type": "integer", "minimum": 0 },
+        "field": { "type": "string", "minLength": 1, "maxLength": 1024 }
+      }
+    },
+    "events": { "type": "array" },
+    "total_matches": { "type": "integer", "minimum": 0 },
+    "next_cursor": { "type": "string", "minLength": 1 },
+    "eof": { "type": "boolean" },
+    "redactions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["rule_id", "count"],
+        "properties": {
+          "rule_id": { "type": "string", "minLength": 1 },
+          "count": { "type": "integer", "minimum": 1 }
+        }
+      }
+    }
+  }
+}

package/docs/schemas/verifier-assessment.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Hitch artifact-only verifier assessment v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "candidate_executes", "eval_id", "task_id", "attempt", "rerun_id", "source", "controller_runtime_id", "backend", "observation", "evidence_digest", "completed_at"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "kind": { "const": "verifier-only-assessment" },
+    "candidate_executes": { "const": false },
+    "eval_id": { "type": "string", "pattern": "^eval_[a-f0-9]{32}$" },
+    "task_id": { "type": "string", "minLength": 1 },
+    "attempt": { "type": "integer", "minimum": 1 },
+    "rerun_id": { "type": "string", "pattern": "^rerun_[a-f0-9]{32}$" },
+    "controller_runtime_id": { "$ref": "#/$defs/digest" },
+    "runtime_repair": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schema_version", "kind", "source_runtime_id", "replacement_runtime_id", "path", "source_sha256", "replacement_sha256", "unchanged_file_count"],
+      "properties": {
+        "schema_version": { "const": "1" }, "kind": { "const": "verifier-environment-runtime-repair" },
+        "source_runtime_id": { "$ref": "#/$defs/digest" }, "replacement_runtime_id": { "$ref": "#/$defs/digest" },
+        "path": { "const": "integrations/harbor/hitch_harbor_environment.py" },
+        "source_sha256": { "$ref": "#/$defs/digest" }, "replacement_sha256": { "$ref": "#/$defs/digest" },
+        "unchanged_file_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "evidence_digest": { "$ref": "#/$defs/digest" },
+    "completed_at": { "type": "string", "format": "date-time" },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["trial_id", "run_id", "work_id", "backend_directory", "bundle_index_digest", "trial_tree_digest", "artifacts_digest", "task_tree_digest", "artifact_capture_at"],
+      "properties": {
+        "trial_id": { "type": "string", "minLength": 1 },
+        "run_id": { "type": "string", "pattern": "^run_[a-f0-9]{32}$" },
+        "controller_runtime_id": { "$ref": "#/$defs/digest" },
+        "work_id": { "type": "string", "pattern": "^work_[a-f0-9]{32}$" },
+        "backend_directory": { "type": "string", "minLength": 1 },
+        "bundle_index_digest": { "$ref": "#/$defs/digest" },
+        "trial_tree_digest": { "$ref": "#/$defs/digest" },
+        "artifacts_digest": { "$ref": "#/$defs/digest" },
+        "task_tree_digest": { "$ref": "#/$defs/digest" },
+        "artifact_capture_at": { "type": "string", "format": "date-time" }
+      }
+    },
+    "backend": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version", "identity", "process_exit_code", "signal"],
+      "properties": {
+        "name": { "const": "harbor" },
+        "version": { "const": "0.21.0" },
+        "identity": { "type": "string" },
+        "process_exit_code": { "type": ["integer", "null"] },
+        "signal": { "type": ["string", "null"] }
+      }
+    },
+    "observation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status"],
+      "properties": {
+        "status": { "enum": ["valid", "invalid"] },
+        "reward": { "type": "number" },
+        "invalid_reason": { "type": "string", "minLength": 1 },
+        "verifier_result_ref": { "type": "string", "minLength": 1 }
+      },
+      "allOf": [{
+        "if": { "properties": { "status": { "const": "valid" } } },
+        "then": { "required": ["reward", "verifier_result_ref"], "not": { "required": ["invalid_reason"] } },
+        "else": { "required": ["invalid_reason"] }
+      }]
+    }
+  },
+  "allOf": [{ "if": { "required": ["runtime_repair"] }, "then": { "properties": { "source": { "required": ["controller_runtime_id"] } } } }],
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }
+}

package/docs/schemas/verifier-evidence.schema.json

@@ -0,0 +1,276 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/rsi-gear/agent-hitch/blob/main/docs/schemas/verifier-evidence.schema.json",
+  "title": "Hitch Verifier Evidence V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "run_id", "verifier"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "kind": { "const": "verifier-evidence" },
+    "run_id": { "type": "string", "pattern": "^run_[a-f0-9]{32}$" },
+    "parent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["eval_id", "trial_id", "attempt"],
+      "properties": {
+        "eval_id": { "type": "string", "pattern": "^eval_[a-f0-9]{32}$" },
+        "trial_id": { "type": "string", "minLength": 1 },
+        "attempt": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "observation": { "$ref": "#/$defs/observation" },
+    "verifier": { "$ref": "#/$defs/verifier" },
+    "redactions": { "type": "array", "items": { "$ref": "#/$defs/redaction" } }
+  },
+  "$defs": {
+    "observation": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "reward", "verifier_result_ref"],
+          "properties": {
+            "status": { "const": "valid" },
+            "reward": { "type": "number" },
+            "verifier_result_ref": { "$ref": "#/$defs/relativePath" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "invalid_reason"],
+          "properties": {
+            "status": { "const": "invalid" },
+            "invalid_reason": { "type": "string", "minLength": 1 },
+            "verifier_result_ref": { "$ref": "#/$defs/relativePath" }
+          }
+        }
+      ]
+    },
+    "verifier": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status"],
+      "properties": {
+        "status": { "enum": ["complete", "result_only", "missing", "corrupt"] },
+        "result": {},
+        "result_sha256": { "$ref": "#/$defs/sha256" },
+        "scores": { "$ref": "#/$defs/scores" },
+        "process": { "$ref": "#/$defs/process" },
+        "feedback": { "$ref": "#/$defs/feedback" },
+        "structured_artifacts": {
+          "type": "object",
+          "additionalProperties": false,
+          "minProperties": 1,
+          "properties": {
+            "process": { "$ref": "#/$defs/structuredArtifact" },
+            "feedback": { "$ref": "#/$defs/structuredArtifact" }
+          }
+        },
+        "diagnostics": { "$ref": "#/$defs/diagnostics" },
+        "issues": { "type": "array", "maxItems": 16, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "status": { "const": "complete" } }, "required": ["status"] },
+          "then": {
+            "required": ["result", "result_sha256", "diagnostics"],
+            "properties": {
+              "diagnostics": {
+                "allOf": [
+                  { "$ref": "#/$defs/diagnostics" },
+                  { "anyOf": [{ "required": ["ctrf"] }, { "required": ["stdout"] }, { "required": ["stderr"] }] }
+                ]
+              }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "status": { "const": "result_only" } }, "required": ["status"] },
+          "then": {
+            "required": ["result", "result_sha256"],
+            "properties": {
+              "diagnostics": {
+                "allOf": [
+                  { "$ref": "#/$defs/diagnostics" },
+                  { "not": { "anyOf": [{ "required": ["ctrf"] }, { "required": ["stdout"] }, { "required": ["stderr"] }] } }
+                ]
+              }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "status": { "const": "missing" } }, "required": ["status"] },
+          "then": { "not": { "required": ["result"] } }
+        }
+      ]
+    },
+    "scores": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total_score", "normalization"],
+      "properties": {
+        "total_score": { "type": "number" },
+        "process_score": { "type": "number" },
+        "normalization": { "enum": ["standard", "legacy-reward"] }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "normalization": { "const": "legacy-reward" } }, "required": ["normalization"] },
+          "then": { "not": { "required": ["process_score"] } }
+        }
+      ]
+    },
+    "process": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "metric", "score", "detail_status"],
+      "properties": {
+        "schema_version": { "const": "1" },
+        "metric": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$" },
+        "score": { "type": "number" },
+        "detail_status": { "enum": ["components", "aggregate-only"] },
+        "passed": { "type": "integer", "minimum": 0 },
+        "total": { "type": "integer", "minimum": 0 },
+        "excluded": { "type": "integer", "minimum": 0 },
+        "components": { "type": "array", "items": { "$ref": "#/$defs/processComponent" } }
+      },
+      "oneOf": [
+        {
+          "properties": { "detail_status": { "const": "components" } },
+          "required": ["detail_status", "passed", "total", "excluded", "components"]
+        },
+        {
+          "properties": { "detail_status": { "const": "aggregate-only" } },
+          "required": ["detail_status"],
+          "not": { "anyOf": [{ "required": ["passed"] }, { "required": ["total"] }, { "required": ["excluded"] }, { "required": ["components"] }] }
+        }
+      ]
+    },
+    "processComponent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "category", "status", "weight"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$" },
+        "category": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$" },
+        "status": { "enum": ["passed", "failed", "excluded"] },
+        "weight": { "type": "number", "exclusiveMinimum": 0 },
+        "code": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$" },
+        "public_details": { "type": "object" },
+        "private_details_ref": { "$ref": "#/$defs/relativePath" },
+        "trajectory_refs": { "type": "array", "items": { "$ref": "#/$defs/trajectoryRef" } }
+      }
+    },
+    "feedback": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "items"],
+      "properties": {
+        "schema_version": { "const": "1" },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["code", "severity", "message"],
+            "properties": {
+              "code": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$" },
+              "severity": { "enum": ["info", "warning", "error"] },
+              "message": { "type": "string", "minLength": 1, "maxLength": 16384 },
+              "component_ids": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$" } },
+              "trajectory_refs": { "type": "array", "items": { "$ref": "#/$defs/trajectoryRef" } }
+            }
+          }
+        }
+      }
+    },
+    "trajectoryRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["run_id"],
+      "properties": {
+        "run_id": { "type": "string", "pattern": "^run_[a-f0-9]{32}$" },
+        "seq_start": { "type": "integer", "minimum": 0 },
+        "seq_end": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "structuredArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "bytes", "sha256"],
+      "properties": {
+        "ref": { "enum": ["verifier/process.json", "verifier/feedback.json"] },
+        "bytes": { "type": "integer", "minimum": 0 },
+        "sha256": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "diagnostics": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "ctrf": { "$ref": "#/$defs/artifact" },
+        "stdout": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/artifact" } },
+        "stderr": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/artifact" } },
+        "infrastructure_error": {},
+        "retry_history": { "type": "array", "minItems": 1, "items": {} }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "media_type", "bytes", "sha256", "truncated"],
+      "properties": {
+        "name": { "enum": ["ctrf.json", "test-stdout.txt", "test-stderr.txt", "stdout.txt", "stderr.txt"] },
+        "media_type": { "enum": ["application/json", "text/plain"] },
+        "bytes": { "type": "integer", "minimum": 0 },
+        "sha256": { "$ref": "#/$defs/sha256" },
+        "truncated": { "type": "boolean" },
+        "json": {},
+        "text": { "type": "string" }
+      },
+      "oneOf": [
+        { "required": ["json"], "not": { "required": ["text"] } },
+        { "required": ["text"], "not": { "required": ["json"] } }
+      ],
+      "allOf": [
+        {
+          "if": { "properties": { "name": { "const": "ctrf.json" } }, "required": ["name"] },
+          "then": { "properties": { "media_type": { "const": "application/json" } } },
+          "else": { "properties": { "media_type": { "const": "text/plain" } } }
+        },
+        {
+          "if": { "properties": { "truncated": { "const": true } }, "required": ["truncated"] },
+          "then": { "required": ["text"], "not": { "required": ["json"] } }
+        },
+        {
+          "if": { "required": ["json"] },
+          "then": {
+            "properties": {
+              "name": { "const": "ctrf.json" },
+              "media_type": { "const": "application/json" },
+              "truncated": { "const": false }
+            }
+          }
+        }
+      ]
+    },
+    "redaction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["rule_id", "count"],
+      "properties": {
+        "rule_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{0,127}$" },
+        "count": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.?(?:/|$))(?!.*\\\\).+$"
+    },
+    "sha256": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+  }
+}