Interface RecordSinkOptions

The executor's sink option in its long form. The short form is the adapter itself.

new FlowChartExecutor(chart, { sink: { adapter: fileSink('/var/footprint/run.jsonl'), onFailure: 'fail' } });

interface RecordSinkOptions {
    adapter: RecordSink;
    capture?: CaptureHistoryOptions;
    flush?: RecordSinkFlushMode;
    onFailure?: RecordSinkFailureMode;
}

Properties

adapter: RecordSink

Where the entries go — fileSink(path) (footprintjs/sinks), memorySink() (foottrace/write), or yours.

Opt-in capture evidence and explicit host acknowledgement; ordinary flush never implies durability.

'auto' (default): run() awaits the adapter's flush() after the closing entry. 'manual': flushRecord().

'report' (default): a lost entry is counted and the run goes on. 'fail': the first one fails the run.