Class: CheckInRecorder

Defined in: src/recorders/core/CheckInRecorder.ts:90

A queryable store of every check-in ask + decision. Attach once; read after the run (or between runs — it accumulates across agent.run() calls until you detach or make a fresh one).

Example

const checkins = new CheckInRecorder();
  agent.attach(checkins);
  await agent.run({ message });
  // ...human approves...
  await agent.resume(outcome.checkpoint, checkInApproved({ by: 'alice' }));
  checkins.getStats();     // { requested: 1, approved: 1, declined: 0, pending: 0 }
  checkins.getDecisions(); // [{ toolName, approved: true, by: 'alice', ... }]

Implements

• CombinedRecorder

Constructors

Constructor

new CheckInRecorder(id?): CheckInRecorder

Defined in: src/recorders/core/CheckInRecorder.ts:99

Parameters

id?

string = 'agentfootprint.checkin-recorder'

Stable recorder id for idempotent attach/detach. Give distinct ids if you attach more than one to the same agent.

Returns

CheckInRecorder

Properties

id

readonly id: string

Defined in: src/recorders/core/CheckInRecorder.ts:91

Implementation of

CombinedRecorder.id

Methods

getDecisions()

getDecisions(): readonly CheckInDecisionRecord[]

Defined in: src/recorders/core/CheckInRecorder.ts:132

Every human decision captured, oldest first.

Returns

readonly CheckInDecisionRecord[]

getRequests()

getRequests(): readonly CheckInRequestRecord[]

Defined in: src/recorders/core/CheckInRecorder.ts:127

Every check-in ask captured, oldest first.

Returns

readonly CheckInRequestRecord[]

getStats()

getStats(): CheckInStats

Defined in: src/recorders/core/CheckInRecorder.ts:137

Roll-up counts. pending = asks still awaiting a decision.

Returns

CheckInStats

onEmit()

onEmit(event): void

Defined in: src/recorders/core/CheckInRecorder.ts:103

Fires for every scope.$emit(name, payload) call during a stage. Optional — implement only if you want to observe consumer-emitted structured events. See EmitRecorder for the focused interface (structurally compatible; this field is the same shape).

Parameters

event

EmitEvent

Returns

void

See

EmitRecorder in src/lib/recorder/EmitRecorder.ts

Implementation of

ScopeRecorder.onEmit

reset()

reset(): void

Defined in: src/recorders/core/CheckInRecorder.ts:150

Drop all captured records (e.g. between runs when reusing the recorder).

Returns

void