Skip to content

readActivitySignal

readActivitySignal(path): SessionActivity | null

Defined in: src/activity-signal.ts:82

Synchronously derive an activity signal from a session JSONL transcript. Missing/unreadable file → null (“no signal yet”). Also returns null when the transcript has no parseable records at all (e.g. a brand-new session). Reads only the tail of the file (bounded by MAX_TAIL_BYTES) to avoid blocking the event loop on large transcripts.

string

SessionActivity | null