Method finalize

explainshell/extraction/llm/extractor.py:330–366

Finalize extraction from batch responses. Used by run_batch after collecting provider results. The returned stats carry ``chunks`` and ``plain_text_len``; token counts are tracked at the batch level by the runner.

(
        self,
        gz_path: str,
        prepared: PreparedFile,
        responses: list[str],
    )

        )

    def finalize(
        self,
        gz_path: str,
        prepared: PreparedFile,
        responses: list[str],
    ) -> ExtractionResult:
        """Finalize extraction from batch responses.

        Used by run_batch after collecting provider results.  The returned
        stats carry ``chunks`` and ``plain_text_len``; token counts are
        tracked at the batch level by the runner.
        """
        all_chunk_data: list[ChunkResult] = []
        stats = ExtractionStats(
            chunks=prepared.n_chunks,
            plain_text_len=prepared.plain_text_len,
        )

        for chunk_idx, response_text in enumerate(responses):
            try:
                chunk_data, raw = process_llm_result(response_text)
            except ExtractionError as e:
                if e.raw_response:
                    self._dump_failed_response(gz_path, chunk_idx, e.raw_response)
                raise

            messages = self._build_messages(prepared.requests[chunk_idx])
            all_chunk_data.append(
                ChunkResult(
                    data=chunk_data,
                    messages=messages,
                    raw_response=raw,
                    usage=TokenUsage(0, 0),
                )
            )

        return self._finalize(gz_path, prepared, all_chunk_data, stats)

    def _finalize(
        self,