HarnessRun

HarnessRun<TOutput> = OutputField<TOutput> & object

Normalized result returned by every harness execution.

Type Declaration

artifacts?

optional artifacts?: Record<string, JsonValue>

JSON-safe run artifacts captured by the harness or test context.

errors

errors: Record<string, JsonValue>[]

Normalized errors captured during execution.

session

session: NormalizedSession

Normalized transcript and provider/session metadata.

timings?

optional timings?: TimingSummary

Optional timing summary for the run.

usage

usage: UsageSummary

Stable provider usage units such as tokens, tools, and retries.

Type Parameters

TOutput

TOutput extends JsonValue | undefined = JsonValue | undefined

Example

const run: HarnessRun<{ status: "approved" }> = {
  output: { status: "approved" },
  session: {
    messages: [
      { role: "user", content: "Refund invoice inv_123" },
      { role: "assistant", content: { status: "approved" } },
    ],
  },
  usage: { totalTokens: 260 },
  errors: [],
};