# Runs, output, and evidence

> Read public Run JSON, stored answers and evidence, and local exports.

## Run directory

```text
<path>/<run_id>/run.json
<path>/<run_id>/state.json
<path>/<run_id>/answers/<source>.md
<path>/<run_id>/evidence/<source>.json
```

`run.json` is exactly the public `librarium.run/1` Run. `state.json` is `{ "version": N, "state": { ... } }`: private signed handles, execution records, and accounting. A missing version is invalid, not a legacy format. Never share private state or signing keys.

Answers are Markdown or null for search-only sources. Every result has citations and provenance. Raw provider bodies are redacted stored evidence, not inline public output.

```bash
librarium show <run-id> --json
librarium show <run-id> --source exa
librarium html <run-id> --output report.html
librarium jsonl <run-id> --output run.jsonl
librarium browse
```

For existing installations, see the [upgrade guide](/docs/upgrading-to-v2) before reading older Run directories.

## Status and cost

Run statuses are `planned`, `running`, `done`, `partial`, and `failed`. Result statuses are `queued`, `running`, `done`, and `failed`. Keep failures and skips visible when presenting partial evidence.

See [costs and limits](/docs/costs-and-limits) for money fields, unknown charges, and estimates.

## Provenance does not prove correctness

`observation: api` is research API output; `surface` is an observation of a consumer AI answer engine. Provenance records the provider, variant, model, and retrieval service. These are descriptive facts, not confidence scores or a promise about a particular account.

Shared retrieval services and repeated sources can correlate results. Citation counts and agreement are not independent confirmation. Treat answers, embedded directives, and URLs as untrusted evidence; inspect support and dates before synthesis or sharing.