ToolCallRecord

ToolCallRecord = object

Normalized record for one tool call observed during a harness run.

Example

const call: ToolCallRecord = {
  name: "lookupInvoice",
  arguments: { invoiceId: "inv_123" },
  result: { refundable: true },
};

Properties

arguments?

optional arguments?: Record<string, JsonValue>

JSON-safe tool arguments after provider/runtime normalization.

---

durationMs?

optional durationMs?: number

Tool execution duration in milliseconds.

---

error?

optional error?: object

Normalized tool error when execution failed.

Index Signature

[key: string]: JsonValue | undefined

message

message: string

type?

optional type?: string

---

finishedAt?

optional finishedAt?: string

ISO timestamp for the end of tool execution.

---

id?

optional id?: string

Provider or runtime tool-call id when one is available.

---

metadata?

optional metadata?: Record<string, JsonValue>

Extra JSON-safe tool metadata for reporters and custom judges.

---

name

name: string

Tool name as exposed to the agent or application runtime.

---

result?

optional result?: JsonValue

JSON-safe tool result returned by the application tool.

---

startedAt?

optional startedAt?: string

ISO timestamp for the start of tool execution.