Class MockLLM

paperflow/providers/llm.py:332–365

Deterministic offline backend used when no credentials are available. Returns a stable hash-derived snippet so call sites can run end-to-end in tests without making network calls. The text is not meaningful — it is only intended to keep pipelines flowing.

class MockLLM:
    """Deterministic offline backend used when no credentials are available.

    Returns a stable hash-derived snippet so call sites can run end-to-end in
    tests without making network calls. The text is not meaningful — it is
    only intended to keep pipelines flowing.
    """

    name = "mock"

    def __init__(self, model: str = "mock-llm") -> None:
        self.model = model

    def generate(
        self,
        prompt: str,
        *,
        system: Optional[str] = None,
        temperature: float = 0.0,
        max_tokens: int = 1024,
    ) -> LLMResponse:
        digest = hashlib.sha256((system or "").encode("utf-8") + b"||" + prompt.encode("utf-8")).hexdigest()
        text = f"[mock-llm:{digest[:12]}] {prompt[:120]}"
        return LLMResponse(text=text, model=self.model, provider=self.name)

    def stream_generate(
        self,
        prompt: str,
        *,
        system: Optional[str] = None,
        temperature: float = 0.0,
        max_tokens: int = 1024,
    ) -> Iterator[str]:
        yield from _chunk_text(self.generate(prompt, system=system, temperature=temperature, max_tokens=max_tokens).text)


def _is_placeholder(value: Optional[str]) -> bool: