RunRow
Defined in: .upstream/src/client/types.ts:88
Properties
Section titled “Properties”agentName
Section titled “agentName”agentName:
string
Defined in: .upstream/src/client/types.ts:90
baseCommit
Section titled “baseCommit”baseCommit:
string|null
Defined in: .upstream/src/client/types.ts:143
Base-commit pin (warren-aaf7): 40-hex SHA the workspace was cut at. Null when unset.
branch
Section titled “branch”branch:
string|null
Defined in: .upstream/src/client/types.ts:139
The composed workspace branch the run’s push lands on (warren-5255):
${runBranchPrefix}/${runId}, or targetBranch when that override
pinned it. Frozen at dispatch. Null on rows predating the column.
cloneKind
Section titled “cloneKind”cloneKind:
"replicate"|"continue"|null
Defined in: .upstream/src/client/types.ts:97
commitsAhead
Section titled “commitsAhead”commitsAhead:
number|null
Defined in: .upstream/src/client/types.ts:118
Reap-time measured outcome facts (warren-ab2b / pl-103e): commits the
pushed branch was ahead of the base, plus the parsed git diff --numstat totals. Null = unknown (pre-column rows, skipped/failed
finalize, unmeasurable diff) — never read null as zero.
costBasis
Section titled “costBasis”costBasis:
"api"|"subscription_estimate"
Defined in: .upstream/src/client/types.ts:162
How costUsd was priced (warren-f3c3): subscription_estimate when
the run authenticated via CLAUDE_CODE_OAUTH_TOKEN — an API-priced
estimate, not a bill. api otherwise (and for legacy rows).
costUsd
Section titled “costUsd”costUsd:
number|null
Defined in: .upstream/src/client/types.ts:158
createdAt
Section titled “createdAt”createdAt:
number|null
Defined in: .upstream/src/client/types.ts:109
The queued instant as epoch ms (warren-0af9 / pl-103e step 1), stamped by RunsRepo.create at insert. Null on rows written before the column existed — read as “unknown”, never as zero queue wait.
deletions
Section titled “deletions”deletions:
number|null
Defined in: .upstream/src/client/types.ts:121
endedAt
Section titled “endedAt”endedAt:
string|null
Defined in: .upstream/src/client/types.ts:111
failureReason
Section titled “failureReason”failureReason:
"never_started"|"no_model_response"|"sandbox_failed"|"spawn_failed"|"crashed"|"agent_died"|"timed_out"|"sandbox_run_lost"|"sandbox_unreachable"|"dropped_commit"|"no_changes"|"finalize_failed"|"push_rejected_policy"|"finalize_unposted"|"provider_error"|"oom_killed"|"evicted"|null
Defined in: .upstream/src/client/types.ts:103
filesChanged
Section titled “filesChanged”filesChanged:
number|null
Defined in: .upstream/src/client/types.ts:119
id:
string
Defined in: .upstream/src/client/types.ts:89
insertions
Section titled “insertions”insertions:
number|null
Defined in: .upstream/src/client/types.ts:120
mode:
"batch"
Defined in: .upstream/src/client/types.ts:100
model:
string|null
Defined in: .upstream/src/client/types.ts:149
parentRunId
Section titled “parentRunId”parentRunId:
string|null
Defined in: .upstream/src/client/types.ts:96
Chain back-link (warren-4b11 / warren-e96f); null for root runs.
previewFailureMessage
Section titled “previewFailureMessage”previewFailureMessage:
string|null
Defined in: .upstream/src/client/types.ts:171
previewLastHitAt
Section titled “previewLastHitAt”previewLastHitAt:
string|null
Defined in: .upstream/src/client/types.ts:170
previewPort
Section titled “previewPort”previewPort:
number|null
Defined in: .upstream/src/client/types.ts:168
previewStartedAt
Section titled “previewStartedAt”previewStartedAt:
string|null
Defined in: .upstream/src/client/types.ts:169
previewState
Section titled “previewState”previewState:
"failed"|"starting"|"live"|"torn-down"|null
Defined in: .upstream/src/client/types.ts:167
prMergedAt
Section titled “prMergedAt”prMergedAt:
string|null
Defined in: .upstream/src/client/types.ts:132
projectId
Section titled “projectId”projectId:
string|null
Defined in: .upstream/src/client/types.ts:91
prompt
Section titled “prompt”prompt:
string
Defined in: .upstream/src/client/types.ts:122
provider
Section titled “provider”provider:
string|null
Defined in: .upstream/src/client/types.ts:148
Declared provider/model frozen at dispatch (warren-2ede / #860). Null on rows predating the columns — read as “unknown”.
prState
Section titled “prState”prState:
"open"|"merged"|"closed_unmerged"|null
Defined in: .upstream/src/client/types.ts:131
Merge-watcher PR facts (warren-3bc6 / pl-103e step 6). prState is
the forge-reported PR lifecycle; prMergedAt its merge instant. Null
on runs that never opened a PR or predate the watcher — read null as
“unknown”, never as “not merged”.
prUrl:
string|null
Defined in: .upstream/src/client/types.ts:124
ref:
string|null
Defined in: .upstream/src/client/types.ts:141
Dispatch-supplied git ref the workspace was cloned from (warren-afeb). Null when unset.
renderedAgentJson
Section titled “renderedAgentJson”renderedAgentJson:
unknown
Defined in: .upstream/src/client/types.ts:101
retryOf
Section titled “retryOf”retryOf:
string|null
Defined in: .upstream/src/client/types.ts:99
Infra-lost auto-retry back-link (warren-4af7); null for first-attempt runs.
salvagePath
Section titled “salvagePath”salvagePath:
string|null
Defined in: .upstream/src/client/types.ts:157
salvageRef
Section titled “salvageRef”salvageRef:
string|null
Defined in: .upstream/src/client/types.ts:156
Salvage-before-destroy (warren-cd3b): where a finalize_failed run’s
committed work was captured. salvageRef is the warren/rescue/<runId>
branch on origin; salvagePath is the durable git-bundle file. Both null
when no salvage was captured (or none was needed).
sandboxId
Section titled “sandboxId”sandboxId:
string|null
Defined in: .upstream/src/client/types.ts:92
sandboxRunId
Section titled “sandboxRunId”sandboxRunId:
string|null
Defined in: .upstream/src/client/types.ts:93
seedId
Section titled “seedId”seedId:
string|null
Defined in: .upstream/src/client/types.ts:94
startedAt
Section titled “startedAt”startedAt:
string|null
Defined in: .upstream/src/client/types.ts:110
state:
"queued"|"running"|"succeeded"|"failed"|"cancelled"
Defined in: .upstream/src/client/types.ts:102
targetBranch
Section titled “targetBranch”targetBranch:
string|null
Defined in: .upstream/src/client/types.ts:133
tokensCacheRead
Section titled “tokensCacheRead”tokensCacheRead:
number|null
Defined in: .upstream/src/client/types.ts:165
tokensCacheWrite
Section titled “tokensCacheWrite”tokensCacheWrite:
number|null
Defined in: .upstream/src/client/types.ts:166
tokensInput
Section titled “tokensInput”tokensInput:
number|null
Defined in: .upstream/src/client/types.ts:163
tokensOutput
Section titled “tokensOutput”tokensOutput:
number|null
Defined in: .upstream/src/client/types.ts:164
trigger
Section titled “trigger”trigger:
string
Defined in: .upstream/src/client/types.ts:123