ReferenceSchemas

Model, Tool, And Checkpoint Schemas

Model calls, tool proposals, tool executions, checkpoints, operations, statuses, and side-effect classes.

ModelCall

FieldNotes
projectId, runIdOwnership.
provider, modelOptional provider/model identity.
operationgenerate, stream, or unknown.
statusrunning, ok, or error.
settingsCaptured model settings.
requestArtifactId, responseArtifactIdPayload artifacts.
usage, logprobsOptional provider output.
startedAt, endedAt, error, metadataLifecycle and diagnostics.

ToolProposal

FieldNotes
modelCallIdOptional model call that proposed it.
toolCallIdProvider/runtime call ID.
toolNameStable tool name.
argsArtifactId, argsHashCaptured proposed args.
schemaVersionOptional tool schema version.

ToolExecution

FieldNotes
proposalIdOptional proposal being executed.
toolCallId, toolNameRuntime identity.
statusrunning, ok, error, or blocked.
argsArtifactId, resultArtifactIdPayload artifacts.
argsHash, resultHashStable comparison hashes.
sideEffectClassnone, read, write, external_mutation, or unknown.

Checkpoint

FieldNotes
nameStable selector.
parentEventIdOptional event that produced the state.
stateArtifactId, stateHashState payload and hash.
schemaName, schemaVersionState compatibility.
codeVersion, packageVersionsReplay compatibility metadata.

On this page