coderouter-cli 1.10.0__py3-none-any.whl → 1.10.1__py3-none-any.whl

coderouter/config/schemas.py

@@ -498,6 +498,23 @@ class RuleMatcher(BaseModel):
       workloads can compensate by tuning the threshold, since the
       char/4 heuristic is conservative for CJK and looser for
       English code.
+
+    Variants ([Unreleased] / tool-aware routing, OpenClaw + Pi 由来):
+
+    - ``has_tools: True`` — the request body declares one or more
+      tools (OpenAI ``tools[]`` / Anthropic ``tools[]`` / OpenAI legacy
+      ``functions[]``). Lets operators send tool-laden requests to a
+      tool-capable cloud profile while keeping plain chat on a small
+      local model (typical Raspberry Pi / low-spec deployment shape:
+      a 1-4B local model that cannot reliably tool-call paired with a
+      free-tier cloud chain that can). Distinct from the
+      ``capabilities.tools`` flag on a provider — that flag is read by
+      ``coderouter doctor`` for diagnostics but does NOT gate the
+      fallback chain (the chain just iterates providers in order and
+      engages the v0.3-D tool-downgrade path on non-native ones with
+      ``request.tools`` set). The ``has_tools`` matcher is the
+      profile-level lever for steering tool-laden traffic to the right
+      chain entirely.
     """
 
     model_config = ConfigDict(extra="forbid")
@@ -508,6 +525,13 @@ class RuleMatcher(BaseModel):
     content_regex: str | None = None
     model_pattern: str | None = None
     content_token_count_min: int | None = Field(default=None, ge=1)
+    # [Unreleased]: tool-aware routing (OpenClaw + Raspberry Pi 由来).
+    # See class docstring "Variants ([Unreleased] / tool-aware routing)"
+    # above for the full rationale. Boolean shape mirrors ``has_image`` —
+    # only the ``True`` value is meaningful (matches when the body
+    # declares any tools); ``False`` is rejected by ``_exactly_one``
+    # since a "no-tools" rule would shadow the default fall-through.
+    has_tools: bool | None = None
 
     _MATCHER_FIELDS: tuple[str, ...] = (
         "has_image",
@@ -516,6 +540,7 @@ class RuleMatcher(BaseModel):
         "content_regex",
         "model_pattern",
         "content_token_count_min",
+        "has_tools",
     )
 
     @model_validator(mode="after")

coderouter/routing/auto_router.py

@@ -142,12 +142,40 @@ def _code_fence_ratio(text: str) -> float:
     return fenced / len(text)
 
 
+def _has_tools_in_body(body: dict[str, Any]) -> bool:
+    """True iff the request body declares one or more callable tools.
+
+    Recognized declaration shapes:
+
+    * ``tools: [...]`` — OpenAI Chat Completions ``tools[]`` AND
+      Anthropic Messages API ``tools[]``. Both wire formats put the
+      array at the same top-level key, so a single membership check
+      covers both ingresses.
+    * ``functions: [...]`` — OpenAI legacy ``functions[]`` (deprecated
+      since 2023-11 but still emitted by some agents that pinned old
+      SDK versions). Treated as equivalent to ``tools[]`` for routing
+      purposes.
+
+    A non-list value (or a value of ``None`` / empty list) returns
+    False — agents that initialize the field but populate it lazily
+    are still on the no-tools path until a tool actually appears.
+    """
+    tools = body.get("tools")
+    if isinstance(tools, list) and len(tools) > 0:
+        return True
+    functions = body.get("functions")
+    if isinstance(functions, list) and len(functions) > 0:
+        return True
+    return False
+
+
 def _match_rule(
     rule: AutoRouteRule,
     message: dict[str, Any] | None,
     text: str,
     model: str | None,
     estimated_tokens: int,
+    has_tools: bool,
 ) -> bool:
     m = rule.match
     if m.has_image is True:
@@ -177,6 +205,14 @@ def _match_rule(
         # for English code; operators tune the threshold to match
         # their input distribution.
         return estimated_tokens >= m.content_token_count_min
+    if m.has_tools is True:
+        # [Unreleased]: tool-aware routing (OpenClaw + Pi 由来).
+        # Computed once in ``classify`` from ``body.tools`` /
+        # ``body.functions`` so per-rule evaluation is O(1). See
+        # ``_has_tools_in_body`` for the recognized declaration shapes
+        # and ``RuleMatcher`` docstring for why this is profile-level
+        # routing (not a provider capability gate).
+        return has_tools
     return False  # pragma: no cover — _exactly_one guards against this
 
 
@@ -259,6 +295,11 @@ def classify(body: dict[str, Any], config: CodeRouterConfig) -> str:
     # contribute 0. See ``_estimate_total_tokens`` for the heuristic
     # rationale and the 5-deps tradeoff.
     estimated_tokens = _estimate_total_tokens(body)
+    # [Unreleased]: tool-aware routing (OpenClaw + Pi 由来). Computed
+    # once for both the ``has_tools`` matcher and the signals payload.
+    # See ``_has_tools_in_body`` for the recognized declaration shapes
+    # (OpenAI/Anthropic ``tools[]``, OpenAI legacy ``functions[]``).
+    has_tools = _has_tools_in_body(body)
 
     auto_cfg = config.auto_router
     if auto_cfg is not None and auto_cfg.disabled:
@@ -267,6 +308,7 @@ def classify(body: dict[str, Any], config: CodeRouterConfig) -> str:
             text,
             model,
             estimated_tokens,
+            has_tools,
             disabled=True,
         )
         return auto_cfg.default_rule_profile
@@ -278,17 +320,18 @@ def classify(body: dict[str, Any], config: CodeRouterConfig) -> str:
         else BUNDLED_DEFAULT_RULE_PROFILE
     )
 
-    # ``model_pattern`` and ``content_token_count_min`` matchers can
-    # fire even without a user message (e.g. system-only prompts or a
-    # request body that carries only a model field). Other matchers
-    # still require ``user_msg`` to be present — they short out via
-    # ``_match_rule``'s message-None handling.
+    # ``model_pattern``, ``content_token_count_min`` and ``has_tools``
+    # matchers can fire even without a user message (e.g. system-only
+    # prompts or a request body that carries only a model field +
+    # tools array). Other matchers still require ``user_msg`` to be
+    # present — they short out via ``_match_rule``'s message-None
+    # handling.
     for rule in rules:
-        if _match_rule(rule, user_msg, text, model, estimated_tokens):
-            _emit_resolved(rule, user_msg, text, model, estimated_tokens)
+        if _match_rule(rule, user_msg, text, model, estimated_tokens, has_tools):
+            _emit_resolved(rule, user_msg, text, model, estimated_tokens, has_tools)
             return rule.profile
 
-    _emit_fallthrough(default_profile, text, model, estimated_tokens)
+    _emit_fallthrough(default_profile, text, model, estimated_tokens, has_tools)
     return default_profile
 
 
@@ -298,6 +341,7 @@ def _emit_resolved(
     text: str,
     model: str | None,
     estimated_tokens: int,
+    has_tools: bool,
 ) -> None:
     logger.info(
         "auto-router-resolved",
@@ -310,6 +354,7 @@ def _emit_resolved(
                 "content_len": len(text),
                 "model": model,
                 "estimated_tokens": estimated_tokens,
+                "has_tools": has_tools,
             },
         },
     )
@@ -320,6 +365,7 @@ def _emit_fallthrough(
     text: str,
     model: str | None,
     estimated_tokens: int,
+    has_tools: bool,
     disabled: bool = False,
 ) -> None:
     logger.info(
@@ -331,6 +377,7 @@ def _emit_fallthrough(
                 "content_len": len(text),
                 "model": model,
                 "estimated_tokens": estimated_tokens,
+                "has_tools": has_tools,
                 "disabled": disabled,
             },
         },

{coderouter_cli-1.10.0.dist-info → coderouter_cli-1.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coderouter-cli
-Version: 1.10.0
+Version: 1.10.1
 Summary: Local-first, free-first, fallback-built-in LLM router. Claude Code / OpenAI compatible.
 Project-URL: Homepage, https://github.com/zephel01/CodeRouter
 Project-URL: Repository, https://github.com/zephel01/CodeRouter

{coderouter_cli-1.10.0.dist-info → coderouter_cli-1.10.1.dist-info}/RECORD

@@ -18,7 +18,7 @@ coderouter/config/__init__.py,sha256=FODEn74fN-qZnt4INPSHswqhOlEgpL6-_onxsitSx8g
 coderouter/config/capability_registry.py,sha256=F6DetVL5oM03R4QeK1g6h_Q_zrXH0opnYDp3duZmkN4,15808
 coderouter/config/env_file.py,sha256=CoMK27fuAXm-NtoLzXb8yN2E-wDFjHQuFwiIlmgTBQw,10356
 coderouter/config/loader.py,sha256=FUEe8m4Tnmj_aul0vSctD8vKvNW-oLRoMRbTpSKqSmc,4077
-coderouter/config/schemas.py,sha256=c3eR1iqyJq_x6kwkyONgDIyVCFbfk20A49B131Ar_0k,36741
+coderouter/config/schemas.py,sha256=OI_78vSvjWTSVJMPER-JhtMIXOVJZ-8QaLH8wj3Snoc,38204
 coderouter/data/__init__.py,sha256=uNyfD9jaCvTWsBAWtaw1Fr25OSxzv3psGMfBjT1z0Cc,328
 coderouter/data/model-capabilities.yaml,sha256=b0CJYfBqnKA8uaOxOdgNf5z9opTZcrC-N2FtsJvxPgw,16911
 coderouter/guards/__init__.py,sha256=eYjuKo0OvE-GjJo7drYtU2XavUPF9OdiTB5IS76c92Y,855
@@ -36,7 +36,7 @@ coderouter/metrics/collector.py,sha256=y4MUAAF_nf9nml6c_NwRwt_1BsIqCXVL1oLrxGmXF
 coderouter/metrics/prometheus.py,sha256=GveI6OyWCACOet05Enpv1gxGrJ-wqpMWLiTRceT0bAw,16913
 coderouter/routing/__init__.py,sha256=g2vhutbozRx5QBThReqwPN3imk5qXdpDiaogILd3IRc,257
 coderouter/routing/adaptive.py,sha256=pRUphp2_NJ7i6I2HRNk3AkB7Wiu0amZ3vtgBHgmVLBU,20233
-coderouter/routing/auto_router.py,sha256=Lb3ej2mjoqjD5cbvBPmHb8kCvg1ikpau85bei2_CrbI,12503
+coderouter/routing/auto_router.py,sha256=1szbaFMa9mTZPuEOxdxHmVfMNfuH4v4FXkfD4LG3vsc,14571
 coderouter/routing/budget.py,sha256=XZQL24YIkusB2MwfgbIJ1uhW1ODtMMdpbZ5e_A7oSU4,7164
 coderouter/routing/capability.py,sha256=ziIDuE5keH_jxYDlXSKufRVxxSYOAvUxJ6Rw5QkYDDU,18436
 coderouter/routing/fallback.py,sha256=M0jiUJzzvXcHHW-7YhOiDLAx-UJTL5EA_j97w5Ao-10,66540
@@ -44,8 +44,8 @@ coderouter/translation/__init__.py,sha256=PYXN7XVEwpG1uC8RLy6fvnGbzEZhhrEuUapH8I
 coderouter/translation/anthropic.py,sha256=JpvIWNXHUPVqOGvps7o_6ZADhXuJuvpU7RdMqQFtwwM,6421
 coderouter/translation/convert.py,sha256=-qyzFzmmr9hhQV6_Sg75kJnvCZvHe3n7vRdaZtk_JqQ,47269
 coderouter/translation/tool_repair.py,sha256=fyxDb4kWHytO5JWq5y0i4tinJUtWqhMCkyfoCf5BjeM,8314
-coderouter_cli-1.10.0.dist-info/METADATA,sha256=sXwBm1KLnTHo5i3rSNUwqlNURCRZ0u6LgLQdYWrQ5d8,47838
-coderouter_cli-1.10.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-coderouter_cli-1.10.0.dist-info/entry_points.txt,sha256=-dnLfD1YZ2WjH2zSdNCvlO65wYltM9bsHt9Fhg3yGss,51
-coderouter_cli-1.10.0.dist-info/licenses/LICENSE,sha256=wkEzoR86jFw33jvfOHjULqmkGEfxTFMgMaJnpR8mPRw,1065
-coderouter_cli-1.10.0.dist-info/RECORD,,
+coderouter_cli-1.10.1.dist-info/METADATA,sha256=H1f0BXj6vUXy05qjEY1lAah8ItzI_zrnj3rWkWjgU9w,47838
+coderouter_cli-1.10.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+coderouter_cli-1.10.1.dist-info/entry_points.txt,sha256=-dnLfD1YZ2WjH2zSdNCvlO65wYltM9bsHt9Fhg3yGss,51
+coderouter_cli-1.10.1.dist-info/licenses/LICENSE,sha256=wkEzoR86jFw33jvfOHjULqmkGEfxTFMgMaJnpR8mPRw,1065
+coderouter_cli-1.10.1.dist-info/RECORD,,