Coverage for core/langgraph/_builtins_functions.py: 100%

1""" 

2_builtins_functions.py — deterministic, pure engine builtins for the function 

3mechanism (ADR-0037 D4 call-expansion round). 

4 

5Implements the engine-owned pure builtin registered in the deterministic 

6builtin register (00-process-contract § Deterministic builtin surface): 

7 

8- question-block-form deterministic human-interface question-block formation on 

9 exhaustion/stage-escalation → {status, question_block}. 

10 Pure (no LLM). 

11 

12The pure handler and its helpers live in the per-tool module 

13tools/question_block_form.py (single source); this module's handler delegates. 

14""" 

15from __future__ import annotations 

16 

17from typing import Any 

18 

19 

20def question_block_form(step: dict, state: dict) -> dict: 

21 try: 

22 from tools.question_block_form import question_block_form as _exec 

23 except ImportError: # pragma: no cover — main.py run (qualified imports) 

24 from langgraph.tools.question_block_form import question_block_form as _exec 

25 return _exec(step, state) 

26 

27 

28# --------------------------------------------------------------------------- 

29# Registry helper 

30# --------------------------------------------------------------------------- 

31 

32 

33def register_all(executor: Any) -> None: 

34 """Register the function-engine builtins on the executor (hyphen/underscore).""" 

35 executor.register("question-block-form", question_block_form)