echotools 2.3.29__tar.gz → 2.3.30__tar.gz

{echotools-2.3.29 → echotools-2.3.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: echotools
-Version: 2.3.29
+Version: 2.3.30
 Summary: 通用基础设施 SDK：配置、日志、事件、调度、插件、协议、调用链
 Author: nichengfuben
 License: MIT

{echotools-2.3.29 → echotools-2.3.30}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "echotools"
-version = "2.3.29"
+version = "2.3.30"
 description = "通用基础设施 SDK：配置、日志、事件、调度、插件、协议、调用链"
 readme = "docs/README.md"
 requires-python = ">=3.8"

{echotools-2.3.29 → echotools-2.3.30}/src/echotools/exec/fncall/prompt/history_format.py

@@ -18,6 +18,8 @@ from .prompt_helpers import (
 def _format_conversation_history(
     messages: List[Dict[str, Any]],
     protocol: Optional[Any] = None,
+    *,
+    include_thinking_in_history: bool = False,
 ) -> str:
     if not messages:
         return ""
@@ -48,14 +50,16 @@ def _format_conversation_history(
                     tool_msgs.append(messages[j])
                     j += 1
                 block = format_assistant_block_with_results(
-                    m, tool_msgs, protocol, call_id_to_name, seen_assistant_keys
+                    m, tool_msgs, protocol, call_id_to_name, seen_assistant_keys,
+                    include_thinking_in_history=include_thinking_in_history,
                 )
                 if block:
                     parts.append((block, False))
                 i = j
             else:
                 block = format_assistant_block(
-                    m, content_str, protocol, call_id_to_name, seen_assistant_keys
+                    m, content_str, protocol, call_id_to_name, seen_assistant_keys,
+                    include_thinking_in_history=include_thinking_in_history,
                 )
                 if block:
                     parts.append((block, False))

{echotools-2.3.29 → echotools-2.3.30}/src/echotools/exec/fncall/prompt/inject.py

@@ -22,6 +22,10 @@ from echotools.exec.fncall.protocols.entml import (
     format_entml_current_user_message,
 )
 from echotools.exec.fncall.protocols.entml_thinking import build_entml_thinking_section
+from echotools.exec.fncall.protocols.entml_thinking_history import (
+    apply_thinking_history_policy,
+    parse_include_thinking_in_history,
+)
 from echotools.exec.fncall.shared.loop_detect import detect_tool_loop
 from echotools.exec.fncall.shared.normalization import format_tool_descs
 from echotools.exec.protocol.base import ToolProtocol
@@ -96,14 +100,18 @@ def inject_fncall(
     protocol_options: Optional[Dict[str, Any]] = None,
 ) -> List[Dict[str, Any]]:
     """注入工具定义，返回单条 user 消息（含历史）。"""
-    normalized = _normalize_messages(list(messages))
+    include_history = parse_include_thinking_in_history(protocol_options)
+    prepared = apply_thinking_history_policy(list(messages), include_history)
+    normalized = _normalize_messages(prepared)
     history_messages, current_user_message = split_last_user_message(normalized)
 
     if hasattr(protocol, 'clean_tags'):
         current_user_message = protocol.clean_tags(current_user_message)
 
     history_text = _format_conversation_history(
-        history_messages, protocol=protocol
+        history_messages,
+        protocol=protocol,
+        include_thinking_in_history=include_history,
     ).strip()
 
     if not tools:

{echotools-2.3.29 → echotools-2.3.30}/src/echotools/exec/fncall/prompt/prompt_helpers.py

@@ -15,9 +15,37 @@ from .history import (
     _try_convert_user_to_tool,
 )
 
+from echotools.exec.fncall.protocols.entml_thinking_history import (
+    extract_reasoning_text,
+    format_entml_thinking_history_block,
+)
+
 logger = get_logger(__name__)
 
 
+def _assistant_history_content_blocks(
+    m: Dict[str, Any],
+    content_str: str,
+    protocol: Optional[Any],
+    include_thinking_in_history: bool,
+) -> List[str]:
+    """构建 assistant 历史块正文（可选前置 entml:thinking）。"""
+    blocks: List[str] = []
+    if (
+        include_thinking_in_history
+        and protocol is not None
+        and getattr(protocol, "id", None) == "entml"
+    ):
+        reasoning = extract_reasoning_text(m)
+        if reasoning:
+            thinking_block = format_entml_thinking_history_block(reasoning)
+            if thinking_block:
+                blocks.append(thinking_block)
+    if content_str:
+        blocks.append(content_str)
+    return blocks
+
+
 def split_last_user_message(
     normalized: List[Dict[str, Any]],
 ) -> Tuple[List[Dict[str, Any]], str]:
@@ -52,11 +80,13 @@ def format_assistant_block(
     protocol: Optional[Any],
     call_id_to_name: Dict[str, str],
     seen_assistant_keys: Set[Tuple[str, Tuple[Tuple[str, str], ...]]],
+    *,
+    include_thinking_in_history: bool = False,
 ) -> Optional[str]:
     tcs: List[Dict[str, Any]] = m.get("tool_calls") or []
-    blocks: List[str] = []
-    if content_str:
-        blocks.append(content_str)
+    blocks = _assistant_history_content_blocks(
+        m, content_str, protocol, include_thinking_in_history
+    )
     for tc in tcs:
         cid = tc.get("id") or ""
         fn_name = (tc.get("function") or {}).get("name") or ""
@@ -87,6 +117,8 @@ def format_assistant_block_with_results(
     protocol: Optional[Any],
     call_id_to_name: Dict[str, str],
     seen_assistant_keys: Set[Tuple[str, Tuple[Tuple[str, str], ...]]],
+    *,
+    include_thinking_in_history: bool = False,
 ) -> Optional[str]:
     tcs: List[Dict[str, Any]] = m.get("tool_calls") or []
     content_str = normalize_content(m.get("content", ""))
@@ -102,9 +134,9 @@ def format_assistant_block_with_results(
         for tmsg in tool_msgs
     }
 
-    blocks: List[str] = []
-    if content_str:
-        blocks.append(content_str)
+    blocks = _assistant_history_content_blocks(
+        m, content_str, protocol, include_thinking_in_history
+    )
 
     for tc in tcs:
         if protocol is not None and hasattr(protocol, "format_assistant_tool_calls"):

{echotools-2.3.29 → echotools-2.3.30}/src/echotools/exec/fncall/protocols/entml_thinking_history.py

@@ -11,6 +11,29 @@ HISTORY_FLAG_KEYS = (
 )
 _THINKING_BLOCK_TYPES = frozenset({"thinking", "reasoning", "redacted_thinking"})
 
+_THINKING_BLOCK_OPEN = "<entml:thinking>"
+_THINKING_BLOCK_CLOSE = "</entml:thinking>"
+
+
+def format_entml_thinking_history_block(text: str) -> str:
+    """将历史 assistant 思考链格式化为 entml 块（供 conversation_history 使用）。"""
+    stripped = (text or "").strip()
+    if not stripped:
+        return ""
+    return f"{_THINKING_BLOCK_OPEN}\n{stripped}\n{_THINKING_BLOCK_CLOSE}"
+
+
+def parse_include_thinking_in_history(
+    protocol_options: Optional[Mapping[str, Any]],
+) -> bool:
+    """从 protocol_options 解析是否在历史中渲染 assistant 思考链。"""
+    if not protocol_options:
+        return False
+    for key in HISTORY_FLAG_KEYS:
+        if key in protocol_options:
+            return bool(protocol_options[key])
+    return False
+
 
 def parse_interleaved_history(
     body: Mapping[str, Any],

{echotools-2.3.29 → echotools-2.3.30}/src/echotools.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: echotools
-Version: 2.3.29
+Version: 2.3.30
 Summary: 通用基础设施 SDK：配置、日志、事件、调度、插件、协议、调用链
 Author: nichengfuben
 License: MIT

{echotools-2.3.29 → echotools-2.3.30}/src/tests/test_entml_protocol.py

@@ -426,3 +426,43 @@ def test_entml_parse_schema_coercion() -> None:
     calls = parse_entml_tool_calls(sample, tools, schema_index)
     args = json.loads(calls[0]["function"]["arguments"])
     assert args == {"count": 7, "enabled": True, "tags": ["x", "y"]}
+
+
+def test_inject_include_thinking_in_history() -> None:
+    """protocol_options.include_thinking_in_history 应在历史中渲染 entml:thinking。"""
+    proto = get_protocol("entml")
+    tools = [
+        {
+            "type": "function",
+            "function": {
+                "name": "get_weather",
+                "description": "weather",
+                "parameters": {
+                    "type": "object",
+                    "properties": {"city": {"type": "string"}},
+                    "required": ["city"],
+                },
+            },
+        }
+    ]
+    msgs = [
+        {"role": "user", "content": "查北京天气"},
+        {
+            "role": "assistant",
+            "reasoning": "应先调用 get_weather 获取实时数据。",
+            "content": "我来查一下。",
+        },
+        {"role": "user", "content": "那上海呢？"},
+    ]
+    plain = inject_fncall(msgs, tools, proto)[0]["content"]
+    assert "应先调用 get_weather" not in plain
+
+    with_history = inject_fncall(
+        msgs,
+        tools,
+        proto,
+        protocol_options={"include_thinking_in_history": True},
+    )[0]["content"]
+    assert "<entml:thinking>" in with_history
+    assert "应先调用 get_weather 获取实时数据。" in with_history
+    assert "那上海呢？" in with_history