superqode 2.4.8__tar.gz → 2.4.10__tar.gz

{superqode-2.4.8 → superqode-2.4.10}/CHANGELOG.md

@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.4.10] - 2026-09-21
+
+### Jev Tool Routing — Developer Preview
+
+- Route tool catalogues once per turn through Jev in the native SuperQode loop
+  or a local OpenAI, Anthropic, or native Gemini gateway, with shadow mode, a
+  core-tool safety floor, stable turn caching, and fail-open behavior.
+- Launch Codex, Claude Code, OpenCode, Grok Build, Pi, and SuperQode through
+  non-persistent local adapters. Codex is explicitly gateway-limited when its
+  subscription service injects hidden tools; Antigravity remains detect-only.
+- Use the provider-neutral `superqode.jev_tools` Python API, Codex app-server
+  dynamic-tool adapter, local stdio MCP server, or authenticated HTTP/MCP
+  service. Cloud Run deployment artifacts are included but hosting is optional.
+- `superqode optimize setup` performs a non-persistent readiness and Jev
+  connectivity check. `superqode optimize verify <harness>` validates the
+  adapter, controlled schema reduction, and turn-cache reuse without spending
+  coding-model tokens or claiming synthetic savings as harness results.
+- Aggregate gateway reports expose tool and schema-byte reduction without
+  persisting prompts, tool arguments, request bodies, or credentials.
+- OpenCode and Pi use their native Gemini transports so Gemini 3 thought
+  signatures survive tool-call round trips. Generated profiles contain only a
+  local placeholder; the gateway owns and injects the real `GEMINI_API_KEY`.
+- `superqode optimize enable` creates separate managed `*-jev` launchers backed
+  by non-secret 0600 preferences. `status`, `disable`, and `uninstall` complete
+  the reversible lifecycle, and Harness Hub exposes the same Jev routing entry.
+
+## [2.4.9] - 2026-09-20
+
+### Changed
+- Install banner and welcome screen call out Smart Decisions with Jev and SystemOne Harness beside ACP / A2A / UHP.
+- Shortcut bar adds `🧭 :systemone` next to connect, hub, home, and help.
+
 ## [2.4.8] - 2026-09-20
 
 ### 🧠 SystemOne Tune

{superqode-2.4.8 → superqode-2.4.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superqode
-Version: 2.4.8
+Version: 2.4.10
 Summary: The harness layer for coding agents
 Author-email: Shashi Jagtap <info@super-agentic.ai>
 Maintainer-email: Shashi Jagtap <info@super-agentic.ai>
@@ -33,6 +33,8 @@ Requires-Dist: mcp<2,>=1.27.1
 Requires-Dist: anyio>=4.0.0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: httpx-sse>=0.4.3
+Requires-Dist: starlette>=0.41.0
+Requires-Dist: uvicorn>=0.32.0
 Requires-Dist: jsonschema>=4.20.0
 Requires-Dist: pydantic<3,>=2.0
 Requires-Dist: python-frontmatter>=1.1.0
@@ -244,7 +246,7 @@ superqode harness tune --data examples/tune/factory-route-active.csv \
   --batch-size 5 --max-evals 30 --max-reflection-cost 0.50
 ```
 
-In the TUI, run `:systemone tune` or open **Improve decisions** on SystemOne in Harness Hub. See the [SystemOne Tune guide](https://docs.superqode.dev/advanced/systemone/#improve-decisions-with-systemone-tune).
+In the TUI, run `:systemone tune` or open **Improve decisions** on SystemOne in Harness Hub. See the [SystemOne Tune guide](https://docs.superqode.dev/advanced/systemone-tune/).
 
 
 ```bash

{superqode-2.4.8 → superqode-2.4.10}/README.md

@@ -89,7 +89,7 @@ superqode harness tune --data examples/tune/factory-route-active.csv \
   --batch-size 5 --max-evals 30 --max-reflection-cost 0.50
 ```
 
-In the TUI, run `:systemone tune` or open **Improve decisions** on SystemOne in Harness Hub. See the [SystemOne Tune guide](https://docs.superqode.dev/advanced/systemone/#improve-decisions-with-systemone-tune).
+In the TUI, run `:systemone tune` or open **Improve decisions** on SystemOne in Harness Hub. See the [SystemOne Tune guide](https://docs.superqode.dev/advanced/systemone-tune/).
 
 
 ```bash

{superqode-2.4.8 → superqode-2.4.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superqode"
-version = "2.4.8"
+version = "2.4.10"
 description = "The harness layer for coding agents"
 readme = "README.md"
 license = "Apache-2.0"
@@ -45,6 +45,10 @@ dependencies = [
     "anyio>=4.0.0",
     "httpx>=0.28.1",
     "httpx-sse>=0.4.3",
+    # Local tool-schema gateway. FastMCP already uses the same ASGI stack;
+    # declaring it directly keeps `superqode serve optimize` one-install.
+    "starlette>=0.41.0",
+    "uvicorn>=0.32.0",
     # PiPy validates tool-call arguments against each tool's JSON Schema before
     # execution, the way pi validates against TypeBox. Already present through
     # mcp/fastmcp; declared because superqode.pipy imports it directly.

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/__init__.py

@@ -38,7 +38,7 @@ __all__ = [
     "sidebar",
 ]
 
-__version__ = "2.4.8"
+__version__ = "2.4.10"
 
 # Stable, lightweight public extension surface.  Importing this package does
 # not discover or execute third-party extensions; discovery happens only when

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/agent/loop.py

@@ -804,6 +804,7 @@ class AgentLoop:
         allow_peer_agents: bool = True,  # False inside sub/peer agents (no nesting)
         systemone_client: Optional[Any] = None,
         on_systemone: Optional[Callable[[Dict[str, Any]], None]] = None,
+        tool_router: Optional[Any] = None,
     ):
         self.gateway = gateway
         self.tools = tools
@@ -930,6 +931,15 @@ class AgentLoop:
         self.hooks: HookRegistry = hooks if hooks is not None else HookRegistry()
         self._systemone_client = systemone_client
         self.on_systemone = on_systemone
+        if tool_router is None:
+            try:
+                from ..systemone.tool_router import build_tool_router
+
+                tool_router = build_tool_router()
+            except (ImportError, ValueError):
+                tool_router = None
+        self.tool_router = tool_router
+        self.last_tool_routing_plan = None
         self._current_iteration: int = 0
         # session_start fires once per AgentLoop instance, on the first run().
         self._session_started: bool = False
@@ -2397,6 +2407,25 @@ class AgentLoop:
         rubric_rounds = 0
         rubric_result = None
 
+        # Route once and hold the result for the entire turn. This keeps the
+        # schema prefix byte-stable across model steps and preserves provider
+        # prompt-cache reuse. Shadow mode records the same plan without
+        # changing the catalogue sent to the model.
+        routed_tool_plan = None
+        if not fast_chat and self.tool_router is not None:
+            initial_tool_defs = self._get_tool_definitions()
+            routed_tool_plan = await self.tool_router.plan(user_message, initial_tool_defs)
+            self.last_tool_routing_plan = routed_tool_plan
+            if self.on_thinking:
+                if routed_tool_plan.status == "ok":
+                    await self.on_thinking(
+                        "JEV tools "
+                        f"{len(routed_tool_plan.original)}→{len(routed_tool_plan.selected)} "
+                        f"({routed_tool_plan.mode}, {routed_tool_plan.latency_ms}ms)"
+                    )
+                elif routed_tool_plan.status == "fail_open":
+                    await self.on_thinking("JEV tool routing failed open; using all tools")
+
         # Emit initial processing log
         if self.on_thinking:
             await self.on_thinking("Processing request...")
@@ -2434,6 +2463,8 @@ class AgentLoop:
             # Tool definitions are per-iteration: tool_search may have
             # activated deferred tools since the last call.
             tool_defs = [] if fast_chat else self._get_tool_definitions()
+            if routed_tool_plan is not None:
+                tool_defs = self.tool_router.apply(tool_defs, routed_tool_plan)
 
             # Emit iteration log
             if self.on_thinking:

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/app/constants.py

@@ -598,6 +598,8 @@ COMMANDS = [
     ":serve acp",
     ":serve a2a",
     ":serve uhp",
+    ":serve optimize",
+    ":serve jev",
     ":a2a-keys",
     ":a2a-keys secret",
     ":a2a-keys issue",
@@ -842,6 +844,8 @@ COMMANDS = [
     ":harness run",
     ":harness test",
     ":harness eval",
+    ":harness decision-report",
+    ":harness tune",
     ":harness bench",
     ":harness bench-verify",
     ":harness promote",
@@ -895,6 +899,18 @@ COMMANDS = [
     ":harness optimize-omni",
     ":harness optimize-inspect",
     ":harness optimize-ledger",
+    ":optimize",
+    ":optimize enable",
+    ":optimize status",
+    ":optimize disable",
+    ":optimize uninstall",
+    ":optimize setup",
+    ":optimize verify",
+    ":optimize doctor",
+    ":optimize env",
+    ":optimize run",
+    ":optimize bench",
+    ":optimize mcp",
     ":workflow",
     ":workflow status",
     ":workflow presets",

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/app/mixins/clickable_commands.py

@@ -28,6 +28,7 @@ CLICKABLE_COMMANDS: frozenset[str] = frozenset(
         "hub",
         "memory",
         "skills",
+        "systemone",
     }
 )
 

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/app/mixins/commands_impl.py

@@ -943,6 +943,35 @@ class CommandImplMixin:
                 log.write(Text(output + "\n", style=THEME["error"], overflow="fold"))
             return False
 
+    def _jev_optimize_cmd(self, args: str, log: ConversationLog) -> None:
+        """Manage local Jev launchers from the TUI through the public CLI."""
+        try:
+            tokens = shlex.split(args or "status")
+        except ValueError as exc:
+            log.add_error(f"Could not parse :optimize arguments: {exc}")
+            return
+        if tokens[0] not in {
+            "enable",
+            "status",
+            "disable",
+            "uninstall",
+            "doctor",
+            "setup",
+            "verify",
+        }:
+            log.add_info(
+                "Usage: :optimize [status|enable [harness...]|disable [harness...]|"
+                "uninstall|doctor|setup|verify <harness>]"
+            )
+            return
+        self.run_worker(
+            self._superqode_cli_cmd(
+                ["optimize", *tokens],
+                log,
+                "Jev Tool Routing",
+            )
+        )
+
     def _skills_doctor(self, skills_root: Path, log: ConversationLog) -> None:
         """Validate local skill files and show actionable issues."""
         t = Text()

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/app/mixins/connect.py

@@ -3509,7 +3509,7 @@ class ConnectMixin:
         if not is_root:
             t.append("Esc", style=THEME["purple"])
             t.append(" back  ", style=THEME["dim"])
-        t.append("·  1-4\n" if is_root else "·  or type a number\n", style=THEME["dim"])
+        t.append("·  1-5\n" if is_root else "·  or type a number\n", style=THEME["dim"])
 
         if preserve_log:
             # Opened underneath something the user still needs to read, such as

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/app/mixins/harness_hub.py

@@ -211,6 +211,9 @@ class HarnessHubMixin:
         if action == "tune":
             self._handle_command(":systemone tune", log)
             return
+        if action == "jev-routing":
+            self._handle_command(":optimize status", log)
+            return
         item_id = str(getattr(result, "item_id", "") or "")
         item = next((candidate for candidate in items if candidate.id == item_id), None)
         if item is None:

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/app/mixins/slash_commands.py

@@ -493,6 +493,8 @@ class SlashCommandMixin:
             self._mode_cmd(args, log)
         elif c == "hub":
             self._hub_cmd(args, log)
+        elif c == "optimize":
+            self._jev_optimize_cmd(args, log)
         elif c == "context":
             self._show_context(log)
         elif c == "status":

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/app/welcome.py

@@ -230,7 +230,7 @@ def render_welcome(
     desc_text.append("Terminal-first · Any agent or model\n", style=f"bold {THEME['purple']}")
     if not narrow:
         desc_text.append("\n", style="")
-    interoperability = "Local · ACP · MCP · A2A · UHP · BYOK · System One Models"
+    interoperability = "Local · ACP · MCP · A2A · UHP · BYOK · Jev SystemOne Harness"
     if narrow:
         desc_text.append(interoperability, style=THEME["muted"])
     else:

{superqode-2.4.8 → superqode-2.4.10}/src/superqode/app/widgets.py

@@ -1084,6 +1084,7 @@ class HintsBar(Static):
             hints = [
                 ("⏏", ":disconnect", THEME["pink"]),
                 ("⚓", ":hub", THEME["link"]),
+                ("🧭", ":systemone", THEME["cyan"]),
                 ("🧠", ":memory", THEME["link"]),
                 ("📊", ":eval", THEME["link"]),
                 ("⚡", ":skills", THEME["link"]),
@@ -1094,6 +1095,7 @@ class HintsBar(Static):
             hints = [
                 ("🔌", ":connect", THEME["pink"]),
                 ("⚓", ":hub", THEME["link"]),
+                ("🧭", ":systemone", THEME["cyan"]),
                 ("🏠", ":home", THEME["link"]),
                 ("?", ":help", THEME["link"]),
             ]