Skip to main content
These records separate proposal generation, evaluation, acceptance, and independently verified outcomes. Persisted names remain snake_case in both languages. Rules are relative Markdown files. Each needs a title, an Applies to: ... line, and behavioral guidance. A proposal records a change set against a specific accepted base revision; a null change deletes a file. Ordinary fresh executions receive accepted rules, while candidates are visible during authoring and explicit trials. Task completion in an execution report describes runtime execution; use an independent verifier for business success. A reported rationale is agent-authored evidence, not proof of improvement. Records are frozen Pydantic models with unknown fields rejected. model_dump() / model_dump_json() serialize them; model_validate() reconstructs them. Validators shown below enforce record shape, not behavioral correctness.

On this page

EvaluationOutcome, ExecutionReport, FailureNotice, ProposalOutcome, Rule, RuleProposal, TrialArm, TrialCase, ValidationVerdict.

Example

Constructing a rule does not publish it. Agent-authored filesystem changes become proposals; independent validation decides acceptance.

EvaluationOutcome

Source declaration Construct with keyword fields below. Pydantic validates the model and provides its standard serialization methods.

Fields and properties

ExecutionReport

Source declaration Construct with keyword fields below. Pydantic validates the model and provides its standard serialization methods.

Fields and properties

FailureNotice

Source declaration Construct with keyword fields below. Pydantic validates the model and provides its standard serialization methods.

Fields and properties

ProposalOutcome

Source declaration Construct with keyword fields below. Pydantic validates the model and provides its standard serialization methods.

Fields and properties

Rule

One Markdown file. Its directory is its scope; applicability is explicit. Source declaration Construct with keyword fields below. Pydantic validates the model and provides its standard serialization methods.

Fields and properties

Methods

RuleProposal

Source declaration Construct with keyword fields below. Pydantic validates the model and provides its standard serialization methods.

Fields and properties

TrialArm

Host-verified outcome and candidate assignment for one trial arm. Source declaration Construct with keyword fields below. Pydantic validates the model and provides its standard serialization methods.

Fields and properties

Methods

TrialCase

Source declaration Construct with keyword fields below. Pydantic validates the model and provides its standard serialization methods.

Fields and properties

ValidationVerdict

Source declaration Construct with keyword fields below. Pydantic validates the model and provides its standard serialization methods.

Fields and properties


Signatures and fields are generated from the SDK source. See the import index for available entry points.