Skip to content
LykeionDocs

Search documentation

Documentation/Research

Jev

Agents carry out the work in a study; Jev helps review research items before configured stages advance. It is an independent check on the work, not a progress meter or a grade for an agent. Open a study's Review surface to inspect the recorded checks, evidence and outstanding limits.

Your own TypeSafe key

Jev is run by TypeSafe and reviews a study only under its owner's own TypeSafe key. Save yours in Settings → API Tokens; it is stored encrypted on the server and sent only to TypeSafe. Without a key, nothing is sent to TypeSafe: the server still runs its checks, and when a stage needs judgment the study asks its owner in Decisions to approve the stage, redo it with guidance, close the study or park it.

Review the work, item by item

Review concerns the items a stage hands in: for example, sources in Grounding, hypotheses, experimental outputs and values, or assessments and verdicts in Validation. The checks depend on the stage and the item. A failed item can be sent back with a specific reason, while items that still stand can be retained. Study completion still depends on its configured scope and required review.

The server performs checks it can verify mechanically, such as resolving a source or checking that a cited record exists. Jev answers focused questions that require judgment using the supplied research context and evidence. Items that fail applicable prerequisite checks are not necessarily sent to Jev. Review uses bounded evidence for its questions; for example, Grounding screens a source without telling Jev who declared it.

What the stages examine

  • Grounding: whether sources can be resolved and bear on the research question or its conditions, including checks for potentially missed papers.
  • Hypotheses: whether predictions are falsifiable and supported by cited evidence, and whether the exact prediction was already tested.
  • Experimentation: whether recorded outputs and values satisfy the applicable checks; some Jev checks give warnings rather than deciding the stage.
  • Validation: whether recorded assessments and verdicts are supported, with objections and limitations considered where applicable.

The precise checks and available evidence vary. Inspect the recorded questions and results in Review rather than treating this list as a complete checklist.

From checks to the next step

Jev's answers contribute to recorded checks; Lykeion applies its review rules to the results. A stage may pass, carry an unclear item forward, or send failed work back for a limited redo. If the redo still fails, the study is blocked. In some cases the study asks its owner for a decision. When the owner has saved a key but TypeSafe cannot answer, the work waits rather than passing.

Review can identify a weakest item where applicable, giving the Team a more specific starting point. Unclear is distinct from a pass or a failure, and a warning does not necessarily decide the stage. Open Decisions when a person needs to respond, and use scientific stages to follow progress through the study's scope.

Research, better together.