"""Detect forced Anthropic web server tool requests.""" from free_claude_code.core.anthropic import MessagesRequest, Tool from .parsers import content_text def forced_tool_turn_text(request: MessagesRequest) -> str: """Text for parsing forced server-tool inputs: latest user turn only (avoids stale history).""" if not request.messages: return "" for message in reversed(request.messages): if message.role == "user": return content_text(message.content) return "" def forced_server_tool_name(request: MessagesRequest) -> str | None: """Return web_search or web_fetch only when tool_choice forces that server tool.""" tc = request.tool_choice if not isinstance(tc, dict): return None if tc.get("type") != "tool": return None name = tc.get("name") if name in {"web_search", "web_fetch"}: return str(name) return None def has_tool_named(request: MessagesRequest, name: str) -> bool: return any(tool.name == name for tool in request.tools or []) def is_web_server_tool_request(request: MessagesRequest) -> bool: """True when the client forces a web server tool via tool_choice (not merely listed).""" forced = forced_server_tool_name(request) if forced is None: return False return has_tool_named(request, forced) def is_anthropic_server_tool_definition(tool: Tool) -> bool: """Whether ``tool`` refers to an Anthropic server tool (web_search / web_fetch family).""" name = (tool.name or "").strip() if name in ("web_search", "web_fetch"): return True typ = tool.type if isinstance(typ, str): return typ.startswith("web_search") or typ.startswith("web_fetch") return False def has_listed_anthropic_server_tools(request: MessagesRequest) -> bool: """True when tools include web_search / web_fetch-style entries (listed, forced or not).""" return any(is_anthropic_server_tool_definition(t) for t in (request.tools or [])) def unsupported_server_tool_error( request: MessagesRequest, *, web_tools_enabled: bool ) -> str | None: """Return the user-facing error when the resolved provider cannot run server tools.""" forced = forced_server_tool_name(request) if forced and not web_tools_enabled: return ( f"tool_choice forces Anthropic server tool {forced!r}, but local web server tools are " "disabled (ENABLE_WEB_SERVER_TOOLS=false). Enable them or remove the forced server tool." ) if not forced and has_listed_anthropic_server_tools(request): return ( "FCC cannot pass listed Anthropic server tools (web_search / web_fetch) " "to OpenAI Chat upstreams. Set ENABLE_WEB_SERVER_TOOLS=true and force the " "tool with tool_choice, or remove these tools from the request." ) return None