Papers › CausalDS: Benchmarking Causal Reasoning in Data-Science Agents

CausalDS: Benchmarking Causal Reasoning in Data-Science Agents

9 Jul 2026arXiv:2607.08093added by Syntology

Andrej Leban, Yuekai Sun

Title, abstract, authors and date from arXiv's metadata (CC0); this paper is not in the Papers with Code archive (frozen 2025-07-28).

Large language models (LLMs) increasingly act as integrated data-science agents, combining abstract reasoning with advanced tool use. Yet the relevant benchmark landscape largely divides into symbolic causal reasoning benchmarks without realistic data analysis or data analysis benchmarks without a principled causal data-generating structure. Furthermore, existing causal evaluation datasets are often restricted to curated examples from existing sources, with diversity coming from limited templatized variations rather than from systematic generation of novel synthetic causal structures. We introduce CausalDS, a benchmark for evaluating causal reasoning in agentic data-science workflows. Each benchmark instance is a scene consisting of a sampled structural causal model (SCM) with generated observational data and an accompanying synthetic natural-language story grounded in a realistic domain. We optionally ground the composition of the benchmark components in empirical distributions obtained from real-world datasets, thus retaining empirical structure while reducing the "causal parrot" risk through completely synthetic generation. From each scene, we then derive tasks spanning all three of Pearl's rungs, with typical data-science prediction tasks appearing as Rung 1. Most tasks include a data science coding component, where the model typically needs to use several tools to arrive at the final answer due to the frequent presence of imperfect observations, which are generated by an observation model. Additionally, recognizing when a question admits no warranted answer and abstaining is treated as a first-class scored outcome. The benchmark thus jointly evaluates symbolic causal reasoning, data science, uncertainty quantification, abstention, and tool use/coding.

PaperPDFCode Syntology ran

In Syntology For agents, Syntology's MCP tool lists every function and class Syntology harvested from this paper and whether it ran (how to connect): get_harvested_code_for_paper(arxiv_id="2607.08093")

Code

Syntology Ran 16 of 33 code samples harvested from 1 repository linked to this paper; 17 have no recorded run. Of those that ran: 1 ran · honoured contract; 13 ran · our draft was wrong; 2 ran with no contract checked.

By repository: found in paper text by Syntology: 33 samples from 1 repository, 16 ran. The run record, sample by sample. “Ran” means executed on a synthesized input, not that the code is correct or reproduces the paper.

andleb/causalds found in paper text by Syntology report

Reachability, where shown, is from one Syntology probe window (2026-09-16 to 2026-09-18); repositories not probed show nothing. GitHub stars are not tracked.

Code Syntology ran Syntology

33 samples harvested; 16 ran; 1 honoured the contract we drafted; 17 have no recorded run. Read from Syntology's graph 2026-09-24; that is when this build read the record, not when the samples ran.

1ran · honoured contract
13ran · our draft was wrong
2ran
17unverified

Licence: 0 of the 33 samples are pointer only, meaning Syntology does not serve that copy's text. This page shows no code text for any sample; each one links to its file in the repository.

Harvested from andleb/causalds. “Ran” means the sample executed on a synthesized input. It does not mean the output is correct, and nothing here reproduces the paper's results. “Honoured” and “violated” refer to a contract Syntology drafted from the code itself; “our draft was wrong” and “fixture could not drive it” are failures of Syntology's instrument, not of the code.

Each sample ends with its code_sha256, Syntology's identity for that exact code. An agent fetches the stored sample with Syntology's MCP tool get_code(code_sha256="…") (how to connect); click an identity to copy that call.

Repository labels, per sample. official repository: The archive marks this repository official for the paper. named in the paper: The archive records that the paper mentions this repository; it is not marked official. community (archive-listed): In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper. found in paper text by Syntology: Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted. community: Not in the archive's code links for this paper; a community repository Syntology harvested. Samples from a repository marked official are listed first. Licence labels name the repository's licence as recorded at harvest. “Pointer only” means Syntology does not serve that copy's text, for one of four reasons: no licence file was found; the licence was not identified; the licence is recorded as permissive but that copy's record is not marked cleared; or the licence is outside the permissive list Syntology serves text under (MIT, Apache-2.0, BSD and similar). Some licences outside that list permit redistribution, such as WTFPL, and GPL-3.0 under its conditions; they are simply not on the list. Hover a licence label for the reason. File links open the file on GitHub at the default branch, which may have changed since the harvest.

ExamComposition andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · metamorphic tier: deterministic Apache-2.0 (permissive) · 6fdf6553ceeed2b5 · report
TaskType andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · metamorphic tier: deterministic Apache-2.0 (permissive) · e0d77746002a838d · report
_apply_obs_tilt andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · 471a02e4534852ff · report
_portable_repo_path andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · 7eb5370f70e56a33 · report
_read_scene_structure_label andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · 25b539302a57ef8b · report
_resolve_family_weights andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · cd7aca1869f92036 · report
_resolve_obs_weights andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · cedc4f415bde2b77 · report
_scene_variant_dir andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · bfc09c3b80e6fe08 · report
_weighted_choice_from_available andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · 3d6d99900a05a2fd · report
list_scene_variants andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · eae3e3a4f970a69c · report
list_scenes andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · fbf133530644d05a · report
load_scene_public andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong fingerprinted Apache-2.0 (permissive) · 234aa5fbbbf6b308 · report
parse_outcome_type andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · 263573ac913eebcf · report
parse_rung andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · honoured contract fingerprinted Apache-2.0 (permissive) · 0986fc61d9da1545 · report
parse_task_type andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · c7f4edee0b323065 · report
resolve_structural_label andleb/causalds/causalds/exam_builder.py found in paper text by Syntology ran · our draft was wrong Apache-2.0 (permissive) · 0a80820cffeef210 · report
Exam andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 0188381c0a0c1981 · report
ExamItem andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · ae97603a464ef027 · report
OutcomeType andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · f8896f6aa98efe68 · report
OutputVariant andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 010c920e7dcd9a49 · report
Rung andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 51a4180de1afbc91 · report
TaskInputMode andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · fa486f10ca92e91f · report
_apply_output_variant_tilt andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · e5dd3c76df618a46 · report
_apply_rung_tilt andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 321ae7d5014ac05c · report
_assign_opaque_answer_file_stems andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 8e248affd3e201fe · report
_normalize_composition andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · e795869ed09af8ac · report
_resolve_variant_weights andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 26c8d8b2a34e4fbc · report
build_exam andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 8b6c01925666d449 · report
get_output_variant_difficulty_order andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 4c28f9830b3a77fe · report
get_task_input_mode andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · cffe0153b32ba4e9 · report
infer_rung_from_task_type andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · c1f83096d08ad8bb · report
normalize_task_fields andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 9112deda4fa73ebe · report
parse_output_variant andleb/causalds/causalds/exam_builder.py found in paper text by Syntology unverified Apache-2.0 (permissive) · e709ab15df436195 · report

Results from the paper

The Papers with Code archive ends with its 2025-07-28 snapshot. This paper's arXiv identifier, 2607.08093, was issued in July 2026, after that date, so the archive has no leaderboard rows for it.

Report a problem or propose a change · a person checks every report against the paper or source before anything changes; decisions are listed on /corrections