Session
Defined in: src/types.ts:7
Properties
Section titled “Properties”archivedAt
Section titled “archivedAt”archivedAt:
number|null
Defined in: src/types.ts:76
auto:
boolean
Defined in: src/types.ts:61
True when this session was auto-spawned by the drain queue.
autoMergeEnabled
Section titled “autoMergeEnabled”autoMergeEnabled:
boolean|null
Defined in: src/types.ts:53
Full-auto merge opt-in: true/false override, or null to inherit the repo default.
autoMergeRebaseCount
Section titled “autoMergeRebaseCount”autoMergeRebaseCount:
number
Defined in: src/types.ts:56
Consecutive auto-rebase attempts the merge train has spent on this session (runaway guard; reset on operator reply).
autoMergeRebaseHead
Section titled “autoMergeRebaseHead”autoMergeRebaseHead:
string|null
Defined in: src/types.ts:59
The head SHA the merge train last steered a rebase for; null when none outstanding. Guards against re-steering / re-bumping while a rebase for the same head is in flight.
autopilotComplete
Section titled “autopilotComplete”autopilotComplete:
boolean
Defined in: src/types.ts:42
True when autopilot judged the task done with a non-PR deliverable (research / issue creation / one-off answer) — a clean terminal “completed”, distinct from a pause.
autopilotEnabled
Section titled “autopilotEnabled”autopilotEnabled:
boolean|null
Defined in: src/types.ts:35
Autopilot opt-in: true/false override, or null to inherit the repo default.
autopilotPaused
Section titled “autopilotPaused”autopilotPaused:
boolean
Defined in: src/types.ts:39
True when autopilot handed control back for a genuine question / step-cap.
autopilotQuestion
Section titled “autopilotQuestion”autopilotQuestion:
string|null
Defined in: src/types.ts:45
The classifier’s 1–2 sentence hand-back summary — what the agent is waiting for (paused) or what it delivered (complete); null in neither state.
autopilotStepCount
Section titled “autopilotStepCount”autopilotStepCount:
number
Defined in: src/types.ts:37
Count of auto-steers autopilot has spent on this session (runaway guard; reset on PR-open / operator reply).
baseBranch
Section titled “baseBranch”baseBranch:
string
Defined in: src/types.ts:13
branch
Section titled “branch”branch:
string|null
Defined in: src/types.ts:14
claudeSessionId
Section titled “claudeSessionId”claudeSessionId:
string
Defined in: src/types.ts:19
createdAt
Section titled “createdAt”createdAt:
number
Defined in: src/types.ts:74
desig:
string
Defined in: src/types.ts:9
egressApplied
Section titled “egressApplied”egressApplied:
boolean
Defined in: src/types.ts:69
True when the egress firewall was actually applied at spawn (autonomous + backend present).
egressDegraded
Section titled “egressDegraded”egressDegraded:
boolean
Defined in: src/types.ts:71
Autonomous requested but egress backend absent → ran FS-confined with open network.
haltedAt
Section titled “haltedAt”haltedAt:
number|null
Defined in: src/types.ts:80
Epoch ms when haltReason was set; null when not halted.
haltReason
Section titled “haltReason”haltReason:
"error"|"usage_limit"|"completed"|"operator"|null
Defined in: src/types.ts:78
Reason the session halted mid-run; null when not halted.
herdrAgentId
Section titled “herdrAgentId”herdrAgentId:
string
Defined in: src/types.ts:18
herdrSession
Section titled “herdrSession”herdrSession:
string
Defined in: src/types.ts:17
id:
string
Defined in: src/types.ts:8
isolated
Section titled “isolated”isolated:
boolean
Defined in: src/types.ts:16
issueNumber
Section titled “issueNumber”issueNumber:
number|null
Defined in: src/types.ts:63
Backlog issue number this session was spawned for; null for manual/non-issue sessions.
lastState
Section titled “lastState”lastState:
HerdrState
Defined in: src/types.ts:73
mergeTrainPrs
Section titled “mergeTrainPrs”mergeTrainPrs:
number[] |null
Defined in: src/types.ts:31
PR numbers selected by the merge train for this TRAIN session; null on non-train sessions.
mergingPrNumber
Section titled “mergingPrNumber”mergingPrNumber:
number|null
Defined in: src/types.ts:33
The open-PR number observed when a PARTICIPANT session is marked “merging”; null otherwise.
mergingSince
Section titled “mergingSince”mergingSince:
number|null
Defined in: src/types.ts:26
Epoch ms when a launched merge train marked this PR-session as in-flight; null when not in a train. Transient: cleared on merge/close, train archive, or the TTL sweep.
mergingTrainId
Section titled “mergingTrainId”mergingTrainId:
string|null
Defined in: src/types.ts:29
Id of the merge-train session that owns this mark (clears the whole set when that session is archived). Null when not merging.
model:
string|null
Defined in: src/types.ts:21
name:
string
Defined in: src/types.ts:10
planGateEnabled
Section titled “planGateEnabled”planGateEnabled:
boolean|null
Defined in: src/types.ts:47
Plan-gate opt-in: true/false override, or null to inherit the repo default.
planPhase
Section titled “planPhase”planPhase:
"planning"|"executing"|null
Defined in: src/types.ts:49
Plan-gate phase: “planning” (grill+review) → “executing” (gate passed); null = gate off.
prompt
Section titled “prompt”prompt:
string
Defined in: src/types.ts:11
readyToMerge
Section titled “readyToMerge”readyToMerge:
boolean
Defined in: src/types.ts:22
repoPath
Section titled “repoPath”repoPath:
string
Defined in: src/types.ts:12
research
Section titled “research”research:
boolean
Defined in: src/types.ts:51
True for a research-kind task: web research → report PR or GitHub issue; never code-PR-steered.
sandboxApplied
Section titled “sandboxApplied”sandboxApplied:
SandboxProfile|null
Defined in: src/types.ts:65
Sandbox profile actually applied at spawn; null for legacy rows spawned before the feature.
sandboxDegraded
Section titled “sandboxDegraded”sandboxDegraded:
boolean
Defined in: src/types.ts:67
True when a sandboxed profile was requested but no backend was available → ran unconfined.
status
Section titled “status”status:
SessionStatus
Defined in: src/types.ts:72
updatedAt
Section titled “updatedAt”updatedAt:
number
Defined in: src/types.ts:75
worktreePath
Section titled “worktreePath”worktreePath:
string
Defined in: src/types.ts:15