Analyses methods

Create client with analyses(). Start a wave with jobs.analyze, then read its results here.

Python exposes list, defaults, download, and filesystem. Direct get, transcript, and artifact reads are TypeScript-only. In Python, list(job=...) or Trial.analysis gives the result; an analysis download gives its stored evidence.

Both SDKs	TypeScript only
list, defaults, download, filesystem	get, transcript, artifact

list

List visible analyses, newest first. Returns one page or an iterable of TrialAnalysis.

Signature

list(options?: ListAnalysesOptions): AnalysisList;

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

const page = await client.list({
  job: jobId,
  status: ["completed"]
});

page = await client.list(
    job=job_id,
    status=['completed'],
)

Optional scope: my (default), shared, or org; job: source job id; status: list of queued, running, completed, or failed. limit defaults to 50 (maximum 200); cursor continues a page. Python analysis rows are dictionaries: row["id"], row["checks"]. Analysis result fields include failures and cost as well as the per-criterion checks.

defaults

Read the current analysis defaults. Returns AnalyzeDefaults: model, effort, sandbox provider, rubric, and unrendered prompt template.

Signature

defaults(): Promise<AnalyzeDefaults>;

async def defaults() -> AnalyzeDefaults: ...

const defaults = await client.defaults();

defaults = await client.defaults()

Python returns a dictionary. These are current defaults; an existing analysis records the policy it actually ran under.

get

TypeScript only. Read one TrialAnalysis at any status, including an earlier analysis no longer attached to Trial.analysis.

Signature

get(analysisId: string): Promise<TrialAnalysis>;

const analysis = await client.get(analysisId);

Takes one analysis id. Missing or inaccessible records return analysis_not_found.

transcript

TypeScript only. Read the analyzer’s own activity, not the evaluated agent’s trace. Returns AnalysisTranscript.

Signature

transcript(
  analysisId: string,
  options?: AnalysisTranscriptOptions,
): Promise<AnalysisTranscript>;

const transcript = await client.transcript(analysisId, {
  since: 0
});

Optional since is the number of events already read (nonnegative integer, default 0). There is no server-side pagination. total counts all stored events; events starts at since. gateway_calls is returned separately in full on each read. See transcript fields.

artifact

TypeScript only. Read the analyzer’s stored stdout, stderr, or captured home.

Signature

artifact(
  analysisId: string,
  stream: Exclude<AnalysisArtifactStream, "agent-home">
): Promise<string | null>;
artifact(
  analysisId: string,
  stream: "agent-home"
): Promise<Record<string, string> | null>;

const stderr = await client.artifact(
  analysisId,
  "trace-stderr"
);

trace-stdout and trace-stderr return string | null; agent-home returns Record<string, string> | null. Null means not stored. Analyses do not expose trial verifier or trace-atif artifact selectors.

download

Download a settled analysis as a .tar.gz containing its wrapper trial, transcript, logs, and available result artifacts.

Signature

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

async def download(
    analysis_id: str,
    *,
    to: Optional[str] = None,
) -> bytes | str: ...

const path = await client.download(analysisId, {
  to: "./results"
});

path = await client.download(
    analysis_id,
    to='./results',
)

Omit delivery options to return Buffer / bytes; to saves to a directory and returns a path. TypeScript also accepts { stream: true }, returning a raw ReadableStream<Uint8Array> that the caller must verify. Python has no stream option. Queued or running analyses return analysis_not_terminal.

filesystem

Get the analyzer’s RunFilesystem, including its live or captured files, sandbox logs, and process list.

Signature

filesystem(analysisId: string): RunFilesystem;

def filesystem(analysis_id: str) -> 'RunFilesystem': ...

const fs = client.filesystem(analysisId);
const status = await fs.status();

fs = client.filesystem(analysis_id)
status = await fs.status()

This is the analyzer’s sandbox, separate from the trial it analyzed. See filesystem methods.

Get started

Run and inspect

Manage resources

Method reference

Analyses methods

list

defaults

get

transcript

artifact

download

filesystem

​list

​defaults

​get

​transcript

​artifact

​download

​filesystem

list

defaults

get

transcript

artifact

download

filesystem