analyses - Evolve

analyses() returns the analyses client. Analyses are started from a job, with jobs().analyze(); this client reads them back.

list

TypeScript
Python

list(options?: { scope?: "my" | "shared"; job?: string; status?: AnalysisStatus[]; limit?: number; cursor?: string }): AnalysisList

Analysis runs, newest first, each naming the trial, job and task it judged.

for await (const a of analyses().list({
  job: job.id,
  status: ["failed"],
})) {
  console.log(a.id, a.label);
}

def list(
    *,
    scope: Optional[JobListScope] = None,
    job: Optional[str] = None,
    status: Optional[List[AnalysisStatus]] = None,
    limit: Optional[int] = None,
    cursor: Optional[str] = None,
)

Analysis runs, newest first, each naming the trial, job and task it judged.

async for a in analyses().list(
    job=job.id,
    status=["failed"],
):
    print(a["id"], a["label"])

get, transcript, artifact

TypeScript
Python

get(analysisId: string): Promise<TrialAnalysis>
transcript(
  analysisId: string,
  options?: { since?: number },
): Promise<AnalysisTranscript>
artifact(
  analysisId: string,
  stream: "trace-stdout" | "trace-stderr",
): Promise<string | null>
artifact(
  analysisId: string,
  stream: "agent-home",
): Promise<Record<string, string> | null>

The verdict document for every analysis, failed ones included, the analyzer’s own transcript (everything after since in one read), or one stored artifact; an analysis has no verifier log and no trajectory. A run opens to its job’s creator and every member of the organization; any other id answers analysis_not_found (trial_not_found from transcript).

const verdict = await analyses().get("a0a1b2c3-…");

The Python client has list and download only. Read a verdict from the analyzed trial: (await trials().get(trial_id)).analysis.

download

TypeScript
Python

download(analysisId: string): Promise<Buffer>
download(
  analysisId: string,
  options: { to: string },
): Promise<string>
download(
  analysisId: string,
  options: { stream: true },
): Promise<ReadableStream<Uint8Array>>

The run as one .tar.gz, analyze-<analyzed trial>__<7 chars>/: a trial tree of the analyzer’s own run, with artifacts/analysis.json on a completed run. The bytes, the saved file’s path, or a stream. analysis_not_terminal while the run is queued or running.

const path = await analyses().download(
  "a0a1b2c3-…",
  { to: "./analyses" },
);

async def download(
    analysis_id: str,
    *,
    to: Optional[str] = None,
)

The run as one .tar.gz, analyze-<analyzed trial>__<7 chars>/: the bytes, or with to the saved file’s path. analysis_not_found for an id you cannot read, analysis_not_terminal while the run is queued or running.

path = await analyses().download(
    "a0a1b2c3-…",
    to="./analyses",
)

​list

​get, transcript, artifact

​download

list

get, transcript, artifact

download