Function groupIntoTurns

src/diagnostics/token-analyzer.ts:93–109

(messages: Message[])

 * action burst → next user prompt).
 */
export function groupIntoTurns(messages: Message[]): Message[][] {
  const turns: Message[][] = [];
  let current: Message[] = [];
  for (const m of messages) {
    // Start a new turn at each user message — but only once the current turn
    // already contains a user message. This keeps a leading system (or any
    // pre-user preamble) attached to the first user turn instead of orphaning
    // it into a turn of its own, which would inflate the turn count.
    if (m.role === 'user' && current.some(x => x.role === 'user')) {
      turns.push(current);
      current = [];
    }
    current.push(m);
  }
  if (current.length > 0) turns.push(current);
  return turns;
}

export interface AnalyzeOptions {
  /** Tokens consumed by the system prompt; same value applied to every turn. */