@robota-sdk/agent-session-analytics

Session-log timing analysis and reporting for the Robota SDK.

Given persisted session records, it computes per-turn timing intervals (LLM wait vs. tool execution), aggregates across sessions, and renders text reports. Pure functions — no file I/O, no process.*, no CLI concerns; callers load records and write output.

API

| Export | Description | | --------------------------- | ---------------------------------------------------- | | analyzeSession(record) | Compute the timing report for one session record | | aggregateReports(reports) | Aggregate multiple single-session reports | | computeTimingIntervals(h) | Classify a history array into timing intervals | | gapMs(from, to) | Millisecond gap between two timestamps (string/Date) | | formatSingleSession(r) | Render a single-session report as text | | formatAggregateReport(a) | Render an aggregate report as text |

Operates on the canonical IInteractiveSessionRecord projection and IHistoryEntry — owns no duplicate record/history types.

See docs/SPEC.md for the full contract.