Web frontend#

Read run directories as the frontend shows them, and serve them on localhost. See The web frontend to start the frontend.

Reading runs#

`factor_agent.web.run_view.list_runs`	The runs under `root`, the latest written first.
`factor_agent.web.run_view.find_run`	The run directory `list_runs(root)` names `name`, `None` when it names none so.
`factor_agent.web.run_view.run_version`	A text that changes whenever the run in `run_dir` writes, cheap to read: a page polls it before reading the run.
`factor_agent.web.run_view.read_call`	The LLM call of the run in `run_dir` whose call file has `number`, `None` when it has none.
`factor_agent.web.run_view.read_files`	The files `run_dir` was set up with, as its config page shows them.
`factor_agent.web.run_view.read_ic`	The daily IC of trial `slot` (from 0) of `round`; `None` when it was not evaluated or the run kept none.
`factor_agent.web.run_view.RunView`	A read-only snapshot of one run: its summary, the trials of its written rounds, its accepted factors and its memory.
`factor_agent.web.run_view.RunSummary`	What the run list shows of a run.
`factor_agent.web.run_view.Health`	What a run is doing now, as its events file and its process tell.
`factor_agent.web.run_view.Tokens`	Tokens of LLM calls as the providers report them; a count no reply reported is `None`.
`factor_agent.web.run_view.RoundTokens`	The tokens of a round's calls.
`factor_agent.web.run_view.RunningRound`	The round in progress, as its events tell since the run was last opened.
`factor_agent.web.run_view.RoundCall`	An LLM call of the round in progress, as the call timeline shows it.
`factor_agent.web.run_view.PendingTrial`	A pending trial: what is known so far of one slot of the round in progress.
`factor_agent.web.run_view.Check`	One check of a pending trial's candidate: the parser and the Gate on one version of it, or the reviewer.
`factor_agent.web.run_view.LLMCall`	One LLM call of a run, in full, as its call file holds it.
`factor_agent.web.run_view.Trial`	One trial of a written round, as the ledger holds it, with NaN read as `None`.
`factor_agent.web.run_view.Collision`	A trial's refusal for being too like an existing factor: a reference, known or accepted one.
`factor_agent.web.run_view.Factor`	An accepted factor, written up with the facts that say how far to trust it.
`factor_agent.web.run_view.Neighbour`	The factor closest to an accepted one in ranking, and their correlation.
`factor_agent.web.run_view.AcceptanceReports`	What Acceptance has said of a run's accepted factors.
`factor_agent.web.run_view.Comparison`	One Acceptance report: the user's model with and without accepted factors, on validation or the hold-out.
`factor_agent.web.run_view.Contribution`	One accepted factor's contribution to the model in one mode, from an Acceptance report's contribution table.
`factor_agent.web.run_view.HoldoutOpen`	One open of the hold-out, as the hold-out lock records it: `forced` for every open after the first.
`factor_agent.web.run_view.Placed`	An evaluated trial as the admission map places it, with its statistics in its direction.
`factor_agent.web.run_view.Refusal`	The trials one stage refused for the same reason before the Evaluator scored them.
`factor_agent.web.run_view.TrialRef`	A trial named by its round and its slot in the round.
`factor_agent.web.run_view.Finding`	One finding of a run's diagnosis: a thing seen in its trials and what to do about it.
`factor_agent.web.run_view.Stop`	Why a run stopped, as the campaign recorded it: `by` is the stop condition, `reason` its sentence.
`factor_agent.web.run_view.MemoryVersion`	One version of the memory the distiller wrote.
`factor_agent.web.run_view.LineChange`	One line of a text compared with the text before it.
`factor_agent.web.run_view.RunFiles`	The configs of a run, the latest opening first, empty for a run written before configs were kept, and its snapshot's files.
`factor_agent.web.run_view.ConfigCopy`	The config text the run's `opening`-th start or resume was given, opened at `opened_at` (ISO, UTC).
`factor_agent.web.run_view.SnapshotFile`	A file of the run's snapshot by its name there (`fields/<file>`, `operators/<file>`, `prompts/<file>`).
`factor_agent.web.run_view.TrialIC`	An evaluated trial's daily rank IC and partial IC on each day of the label, `None` where unscored.
`factor_agent.web.run_view.AdmissionLimits`	The least coverage and decile monotonicity admission required, as the run's last start recorded them.

Serving#

`factor_agent.web.app.create_app`	The web service over the run directories under `root`.
`factor_agent.web.app.main`	Serve the run directories under a folder on localhost: the `factor-agent-web` console script.