Files
wehub-resource-sync e4dcfc49aa
Tests / Import Check (Python 3.13) (push) Has been cancelled
Tests / Import Check (Python 3.14) (push) Has been cancelled
Tests / Python Tests (Python 3.11) (push) Has been cancelled
Tests / Python Tests (Python 3.12) (push) Has been cancelled
Tests / Python Tests (Python 3.14) (push) Has been cancelled
Tests / Test Summary (push) Has been cancelled
Tests / Lint and Format (push) Has been cancelled
Tests / Web Node Tests (push) Has been cancelled
Tests / Import Check (Python 3.11) (push) Has been cancelled
Tests / Import Check (Python 3.12) (push) Has been cancelled
Tests / Python Tests (Python 3.13) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:00:43 +08:00

92 lines
3.2 KiB
Python

"""Deep Solve loop-capability hooks.
Solve runs as the chat agent loop with a deterministic spine: a committed plan,
a per-step done gate, and a bounded replan (the SolveSession + three owned
tools), while the actual problem-solving happens at the loop's exit using the
shared built-in tools. Active only when the turn is marked ``solve_mode`` by
:class:`deeptutor.capabilities.solve.capability.DeepSolveCapability`.
"""
from __future__ import annotations
from importlib import resources
from typing import Any
from deeptutor.capabilities.protocol import PromptBlock
from deeptutor.capabilities.solve.session import DEFAULT_MAX_REPLANS, get_session
from deeptutor.capabilities.solve.tools import SOLVE_TOOL_NAMES
from deeptutor.core.context import UnifiedContext
class SolveLoopCapability:
"""Turn-scoped integration for deep problem solving.
Reuses the full chat tool surface — every built-in, with the user's
composer toggles respected (web_search / reason / geogebra_analysis mount
iff the user enabled them, exactly as in chat) — and adds the solve spine
(plan / finish-step / replan) on top.
"""
name = "solve"
owned_tools = SOLVE_TOOL_NAMES
def is_active(self, context: UnifiedContext) -> bool:
return bool(context.metadata.get("solve_mode"))
def system_block(
self,
context: UnifiedContext,
*,
language: str,
prompts: dict[str, Any],
) -> PromptBlock | None:
if not self.is_active(context):
return None
override = _prompt_text(prompts, ("solve", "system"))
content = override or _load_system_prompt(language)
return PromptBlock("deep_solve", content)
def augment_kwargs(
self,
tool_name: str,
kwargs: dict[str, Any],
context: UnifiedContext,
) -> dict[str, Any]:
if self.is_active(context) and tool_name in SOLVE_TOOL_NAMES:
session_id = str(context.metadata.get("solve_session_id") or "").strip()
# Seed the replan budget from the solve settings (the solve
# capability forwards ``max_replans`` into metadata); never the model.
session = get_session(session_id)
try:
session.max_replans = int(
context.metadata.get("solve_max_replans", DEFAULT_MAX_REPLANS)
)
except (TypeError, ValueError):
session.max_replans = DEFAULT_MAX_REPLANS
updated = dict(kwargs)
updated["_solve_session_id"] = session_id
return updated
return kwargs
def pre_loop_seed(self, context: UnifiedContext) -> str:
_ = context
return ""
def _prompt_text(prompts: dict[str, Any], path: tuple[str, ...]) -> str:
value: Any = prompts
for key in path:
if not isinstance(value, dict):
return ""
value = value.get(key)
return value if isinstance(value, str) and value else ""
def _load_system_prompt(language: str) -> str:
lang = "zh" if language.lower().startswith("zh") else "en"
prompt = resources.files(__package__).joinpath("prompts", lang, "system.md")
return prompt.read_text(encoding="utf-8").strip()
__all__ = ["SolveLoopCapability"]