session
Make causal analysis reproducible by setting every reachable random generator to a known seed for the duration of a block. Restore RNG state afterward to prevent drift.
Instructions
Set every reachable RNG to a known seed for the duration of the
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jax | No | Yield a fresh JAX ``PRNGKey(seed)`` to the caller via the ``jax_key`` attribute on the yielded session object, when JAX is already imported. Never imports jax on its own. (JAX has no global state so we can't seed it -- agents must thread the key explicitly.) | |
| seed | No | Seed value. ``None`` (the default) means "snapshot current state but don't reseed" -- useful for opportunistic save / restore around code that you don't want to leak RNG drift. | |
| torch | No | Seed PyTorch (CPU + CUDA) when the library is already imported. Never imports torch on its own. | |
| detail | No | Payload depth: 'minimal' (~150 tokens) for sub-step calls where only the point estimate is needed; 'standard' (~1K tokens) for diagnostics + coefficient table; 'agent' (~2K tokens, default) adds violations / next_steps / suggested_functions so the LLM can plan its next call without another round-trip. | agent |
| as_handle | No | If true, cache the fitted result on the server and return result_id + result_uri alongside the JSON payload so a subsequent tools/call can chain without re-running. | |
| data_path | No | Absolute path or URL to a data file. Supported: .csv / .tsv / .txt (delimited), .parquet / .pq, .feather / .arrow, .xlsx / .xls, .dta (Stata), .json / .jsonl. Schemes: file://, s3://, gs://, https://. | |
| result_id | No | Optional handle to a previously-fitted result (returned by an earlier call when as_handle=true). Tools that operate on a fitted object accept this in place of re-supplying data_path + columns. | |
| data_columns | No | Optional column projection. Parquet/Feather/Stata loaders honour this for fast partial reads. | |
| data_sample_n | No | Optional uniform random subsample size (seed=0, deterministic) — useful on huge panels. | |
| pythonhashseed | No | Set ``PYTHONHASHSEED`` for the duration of the block. Most causal-inference numerics don't depend on dict iteration order, but spec-curve enumerators and graph-based DAG search sometimes do. Off by default to avoid surprising downstream callers. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||