Function parseCLIEventsFileAsync

src/core/parser-vscode-cli.ts:429–456

(
  eventsPath: string,
  wsId: string,
  wsName: string,
  customInstructionsBytes?: number,
  onProgress?: (bytesRead: number, totalBytes: number) => void,
)

 * longer blocks the worker for minutes or freezes the host progress bar (issue #106).
 */
export async function parseCLIEventsFileAsync(
  eventsPath: string,
  wsId: string,
  wsName: string,
  customInstructionsBytes?: number,
  onProgress?: (bytesRead: number, totalBytes: number) => void,
): Promise<Session | null> {
  const state = createInitialCliState(wsId);

  let sawAnyEvent = false;
  try {
    await forEachJsonlLineAsync(eventsPath, (line) => {
      if (!line.trim()) return;
      const event = parseCLIEventLine(line);
      if (event) {
        handleCliEvent(event, state, wsId);
        sawAnyEvent = true;
      }
    }, onProgress);
  } catch (e) {
    recordFailedFile('parser-vscode-cli', eventsPath, e);
    return null;
  }

  if (!sawAnyEvent) return null;

  return finalizeCliSession(state, wsId, wsName, customInstructionsBytes);
}