| """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 |
|
|
