Function _classify_step

uncommon_route/proxy.py:1021–1066

Classify the current agentic step from the request body. Returns (step_type, tool_names) where step_type is one of: - "tool-result-followup": last message is a tool result - "tool-selection": tools available, last message is from user - "general": no agentic signals tool_

(body: dict)

def _classify_step(body: dict) -> tuple[str, list[str]]:
    """Classify the current agentic step from the request body.

    Returns (step_type, tool_names) where step_type is one of:
      - "tool-result-followup": last message is a tool result
      - "tool-selection": tools available, last message is from user
      - "general": no agentic signals

    tool_names: function names from the tools array (for hash differentiation).

    Checks both ``tools`` (standard OpenAI) and ``customTools`` (OpenClaw's
    internal format when ``compat.openaiCompletionsTools`` is not enabled).
    """
    messages = body.get("messages", [])
    raw_tools: list[dict[str, Any]] = body.get("tools") or body.get("customTools") or []
    has_tools = bool(raw_tools)

    tool_names: list[str] = []
    for t in raw_tools:
        fn = t.get("function") or t.get("definition") or {}
        name = fn.get("name") or t.get("name") or ""
        if name:
            tool_names.append(name)

    last_message: dict[str, Any] | None = None
    for msg in reversed(messages):
        if msg.get("role") != "system":
            last_message = msg
            break

    last_role = last_message.get("role", "") if isinstance(last_message, dict) else ""
    last_content = last_message.get("content") if isinstance(last_message, dict) else None

    if last_role == "tool":
        return "tool-result-followup", tool_names

    if isinstance(last_content, list) and any(
        isinstance(block, dict) and block.get("type") == "tool_result"
        for block in last_content
    ):
        return "tool-result-followup", tool_names

    if has_tools and last_role == "user":
        return "tool-selection", tool_names

    return "general", tool_names


def _has_vision_content(value: Any) -> bool: