feat(agent): strip raw tool-scaffolding from streamed answers — deterministic filter with one bounded recovery

tests/integration/test_agent_tools.py

@@ -23,7 +23,7 @@ import asyncio
 import uuid
 from collections.abc import AsyncIterator, Iterator
 from copy import deepcopy
-from typing import Any, cast
+from typing import TYPE_CHECKING, Any, cast
 
 import pytest
 from sqlalchemy import delete, text
@@ -35,6 +35,9 @@ from app.rag import agent
 from app.rag.agent import AGENT_TOOLS, AgentHolder, run_agent
 from app.rag.llm import LLMClient, RetryPiece, StreamPiece, ToolCallPiece
 
+if TYPE_CHECKING:
+    from app.rag.scaffolding import ScaffoldingFilter
+
 
 def _doc(db: Session, source: str, path: str, title: str, content: str) -> Document:
     doc = Document(
@@ -168,6 +171,7 @@ class ScriptedToolLLM:
         self,
         messages: list[dict[str, str]],
         tools: list[dict[str, Any]] | None = None,
+        scaffolding: ScaffoldingFilter | None = None,  # phase 71 pass-through
     ) -> AsyncIterator[StreamPiece | ToolCallPiece]:
         self.requests.append((deepcopy(messages), deepcopy(tools)))
         if len(self.requests) == 1: