Class ResponseParser

src/harness/execution/response_parser.py:57–202

Parses LLM responses to extract different types of tool calls. This parser handles three types of tool invocations: 1. Standard OpenAI tool_calls in the response 2. Inline tool calls written as function-call syntax in code blocks 3. Raw bash commands in shell code blocks Exampl

class ResponseParser:
    """Parses LLM responses to extract different types of tool calls.

    This parser handles three types of tool invocations:
    1. Standard OpenAI tool_calls in the response
    2. Inline tool calls written as function-call syntax in code blocks
    3. Raw bash commands in shell code blocks

    Example:
        parser = ResponseParser(
            enable_inline=True,
            allowed_tool_names={"shell_run", "fs_write"},
            submodule_names={"analyze_code"},
        )
        result = parser.parse(llm_message)
        if result.has_error:
            handle_error(result.parse_error)
        elif result.tool_calls:
            execute_tool_calls(result.tool_calls)
    """

    def __init__(
        self,
        enable_inline: bool = False,
        allowed_tool_names: Optional[Set[str]] = None,
        submodule_names: Optional[Set[str]] = None,
    ):
        """Initialize the response parser.

        Args:
            enable_inline: Whether to parse inline tool calls from code blocks.
            allowed_tool_names: Set of valid tool names for inline call detection.
            submodule_names: Set of submodule function names for inline call detection.
        """
        self.enable_inline = enable_inline
        self.allowed_tool_names: Set[str] = allowed_tool_names or set()
        self.submodule_names: Set[str] = submodule_names or set()

    def parse(self, message: Any) -> ParsedResponse:
        """Parse an LLM message and extract all tool calls.

        Args:
            message: The message object from LLM response.
                     Expected to have .content (str) and .tool_calls (list) attributes.

        Returns:
            ParsedResponse containing all extracted tool calls and any parse errors.
        """
        content = message.content or ""
        tool_calls = list(message.tool_calls or [])

        # Truncate to first code block if multiple are present
        if self.enable_inline:
            content = truncate_to_first_code_block(content)

        # Check for malformed inline tools when inline parsing is enabled
        if self.enable_inline:
            error = detect_malformed_code_blocks(content)