koru 0.1.331__py3-none-any.whl → 0.1.332__py3-none-any.whl

koru/agent_backend_runtime.py

@@ -281,6 +281,77 @@ class Nlp2UriDesktopBackend:
         return _nlp2uri_desktop_send(prompt, ide=ide, submit=submit, dry_run=self.dry_run)
 
 
+def _build_plugin_socket_backend(client: IDEControlClient | None) -> AgentBackend:
+    if client is None:
+        raise ValueError("plugin_socket backend requires an IDEControlClient")
+    return PluginSocketBackend(client=client)
+
+def _build_mcp_tool_backend(mcp_server: str | None) -> AgentBackend:
+    return McpToolBackend(mcp_server=mcp_server)
+
+def _build_vendor_agent_cli_backend(shell_client_id: str | None) -> AgentBackend:
+    return TillmShellBackend(
+        client_id=shell_client_id or os.environ.get("KORU_TILLM_CLIENT", "aider"),
+        execute=os.environ.get("KORU_TILLM_DRY_RUN", "").strip().lower()
+        not in {"1", "true", "yes", "on"},
+    )
+
+def _build_gillm_gui_backend() -> AgentBackend:
+    return GillmGuiBackend(client=build_gillm_ide_client())
+
+def _build_os_injector_backend() -> AgentBackend:
+    profile = os.environ.get("KORU_OS_INJECTOR_PROFILE", "").strip()
+    if not profile:
+        raise ValueError("os_injector backend requires KORU_OS_INJECTOR_PROFILE")
+    raw_cfg = os.environ.get("KORU_OS_INJECTOR_CONFIG", "").strip()
+    cfg = Path(raw_cfg).expanduser().resolve() if raw_cfg else None
+    return OsInjectorBackend(profile_id=profile, config_path=cfg)
+
+def _build_nlp2uri_desktop_backend() -> AgentBackend:
+    dry = os.environ.get("KORU_NLP2URI_DRY_RUN", "").strip().lower() in {
+        "1", "true", "yes", "on",
+    }
+    return Nlp2UriDesktopBackend(dry_run=dry)
+
+def _build_imgl_desktop_backend() -> AgentBackend:
+    dry = os.environ.get("KORU_IMGL_DRY_RUN", "").strip().lower() in {
+        "1", "true", "yes", "on",
+    }
+    return ImglDesktopBackend(dry_run=dry)
+
+def _build_vdisplay_control_backend() -> AgentBackend:
+    dry = os.environ.get("KORU_VDISPLAY_DRY_RUN", "").strip().lower() in {
+        "1", "true", "yes", "on",
+    }
+    return VdisplayControlBackend(dry_run=dry)
+
+def _build_noop_backend(noop_reason: str) -> AgentBackend:
+    return NoopBackend(reason=noop_reason)
+
+_BACKEND_BUILDERS = {
+    "plugin_socket": _build_plugin_socket_backend,
+    "vscode_family_plugin_socket": _build_plugin_socket_backend,
+    "mcp_tool": _build_mcp_tool_backend,
+    "mcp_stdio_server": _build_mcp_tool_backend,
+    "vendor_agent_cli": _build_vendor_agent_cli_backend,
+    "gillm_gui": _build_gillm_gui_backend,
+    "gillm_gui_driver": _build_gillm_gui_backend,
+    "os_injector": _build_os_injector_backend,
+    "os_keyboard_injector": _build_os_injector_backend,
+    "nlp2uri_desktop": _build_nlp2uri_desktop_backend,
+    "nlp2uri_desktop_window": _build_nlp2uri_desktop_backend,
+    "imgl": _build_imgl_desktop_backend,
+    "imgl_vision": _build_imgl_desktop_backend,
+    "imgl_desktop": _build_imgl_desktop_backend,
+    "imgl_vision_driver": _build_imgl_desktop_backend,
+    "vdisplay": _build_vdisplay_control_backend,
+    "vdisplay_control": _build_vdisplay_control_backend,
+    "vdisplay_semantic_control": _build_vdisplay_control_backend,
+    "none": _build_noop_backend,
+    "noop": _build_noop_backend,
+    "": _build_noop_backend,
+}
+
 def build_agent_backend(
     *,
     backend_id: str,
@@ -296,44 +367,18 @@ def build_agent_backend(
     """
     bid = (backend_id or "").strip().lower().replace("-", "_")
     normalized = normalize_agent_backend_id(backend_id or "")
-    if bid == "plugin_socket" or normalized == "vscode_family_plugin_socket":
-        if client is None:
-            raise ValueError("plugin_socket backend requires an IDEControlClient")
-        return PluginSocketBackend(client=client)
-    if bid == "mcp_tool" or normalized == "mcp_stdio_server":
-        return McpToolBackend(mcp_server=mcp_server)
-    if normalized == "vendor_agent_cli":
-        return TillmShellBackend(
-            client_id=shell_client_id or os.environ.get("KORU_TILLM_CLIENT", "aider"),
-            execute=os.environ.get("KORU_TILLM_DRY_RUN", "").strip().lower()
-            not in {"1", "true", "yes", "on"},
-        )
-    if bid == "gillm_gui" or normalized == "gillm_gui_driver":
-        return GillmGuiBackend(client=build_gillm_ide_client())
-    if bid == "os_injector" or normalized == "os_keyboard_injector":
-        profile = os.environ.get("KORU_OS_INJECTOR_PROFILE", "").strip()
-        if not profile:
-            raise ValueError("os_injector backend requires KORU_OS_INJECTOR_PROFILE")
-        raw_cfg = os.environ.get("KORU_OS_INJECTOR_CONFIG", "").strip()
-        cfg = Path(raw_cfg).expanduser().resolve() if raw_cfg else None
-        return OsInjectorBackend(profile_id=profile, config_path=cfg)
-    if bid == "nlp2uri_desktop" or normalized == "nlp2uri_desktop_window":
-        dry = os.environ.get("KORU_NLP2URI_DRY_RUN", "").strip().lower() in {
-            "1", "true", "yes", "on",
-        }
-        return Nlp2UriDesktopBackend(dry_run=dry)
-    if bid in ("imgl", "imgl_vision", "imgl_desktop") or normalized == "imgl_vision_driver":
-        dry = os.environ.get("KORU_IMGL_DRY_RUN", "").strip().lower() in {
-            "1", "true", "yes", "on",
-        }
-        return ImglDesktopBackend(dry_run=dry)
-    if bid in ("vdisplay", "vdisplay_control") or normalized == "vdisplay_semantic_control":
-        dry = os.environ.get("KORU_VDISPLAY_DRY_RUN", "").strip().lower() in {
-            "1", "true", "yes", "on",
-        }
-        return VdisplayControlBackend(dry_run=dry)
-    if bid in ("none", "noop", ""):
-        return NoopBackend(reason=noop_reason)
+    builder = _BACKEND_BUILDERS.get(bid) or _BACKEND_BUILDERS.get(normalized)
+    if builder:
+        if "client" in builder.__code__.co_varnames and client is not None:
+            return builder(client=client)
+        elif "mcp_server" in builder.__code__.co_varnames and mcp_server is not None:
+            return builder(mcp_server=mcp_server)
+        elif "shell_client_id" in builder.__code__.co_varnames and shell_client_id is not None:
+            return builder(shell_client_id=shell_client_id)
+        elif "noop_reason" in builder.__code__.co_varnames:
+            return builder(noop_reason=noop_reason)
+        else:
+            return builder()
     raise ValueError(f"unknown agent backend id: {backend_id!r}")
 
 

koru/integrations/imgl_client.py

@@ -87,7 +87,8 @@ def imgl_desktop_transport_enabled() -> bool:
 
 def default_image_path() -> Path:
     if _IMGL_DIRECT:
-        return _default_image_path()
+        p = _default_image_path()
+        return Path(p) if isinstance(p, (str, bytes, os.PathLike)) else p
     raw = os.environ.get("KORU_IMGL_IMAGE", "/tmp/koru-imgl-screen.png").strip()
     return Path(raw).expanduser()
 

koru/integrations/vdisplay_client.py

@@ -619,6 +619,28 @@ def send_chat(
             "fallback_from": "plugin",
         }
 
+
+def _resolve_vql_chat_target(ide: str, hints: dict) -> dict | None:
+    """Resolve chat target using VQL metadata for precise mouse nav on second monitor (DP-1).
+    Used in autonomous PyCharm/JetBrains control via vdisplay + VQL centers (e.g. 1024,640).
+    """
+    vql_target = get_vql_target(ide, role="input", name_contains="chat") or get_vql_target(ide, role="input") or get_vql_target(ide, label="chat")
+    if not vql_target and ide in ("pycharm", "jetbrains"):
+        vql_target = {"click_center": {"x": 1024, "y": 640, "note": "PyCharm/JetBrains editor area on DP-1 second monitor from VQL"}}
+    if vql_target:
+        return {
+            "ok": True,
+            "count": 1,
+            "selected": {
+                "id": vql_target.get("id", "vql-chat"),
+                "backend": "vql",
+                "role": vql_target.get("role"),
+                "click_point": vql_target.get("click_center"),
+                "note": f"VQL target from {vql_target.get('source', 'VQL analysis for second monitor')}"
+            }
+        }
+    return None
+
     canon = _canonical_ide(ide)
     if canon in {"jetbrains", "pycharm"}:
         try:
@@ -668,22 +690,9 @@ def send_chat(
 
     selector, found = _find_first_selector(ide=ide, selectors=_chat_selectors_for(ide))
     if selector is None:
-        # Use VQL target as fallback for chat/input when vision/selector misses (closes observe->act gap)
-        vql_target = get_vql_target(ide, role="input", name_contains="Chat") or get_vql_target(ide, role="input") or get_vql_target(ide, label="chat")
-        if vql_target:
-            # Inject synthetic selector with VQL center for downstream set/click
+        found = _resolve_vql_chat_target(ide, hints)
+        if found:
             selector = {"role": "input", "name_contains": "Chat"}
-            found = {
-                "ok": True,
-                "count": 1,
-                "selected": {
-                    "id": vql_target.get("id", "vql-chat"),
-                    "backend": "vql",
-                    "role": vql_target.get("role"),
-                    "click_point": vql_target.get("click_center"),
-                    "note": f"VQL target from {vql_target.get('source')}"
-                }
-            }
         else:
             return {
                 "ok": False,

{koru-0.1.331.dist-info → koru-0.1.332.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: koru
-Version: 0.1.331
+Version: 0.1.332
 Summary: Closed-loop automation across semcod/* repositories.
 Author: Semcod
 Author-email: Tom Sapletta <tom@sapletta.com>
@@ -156,11 +156,11 @@ Dynamic: license-file
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.331-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$26.95-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-149.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fdeep%2Fdeep--v4--pro-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.332-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$27.58-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-150.2h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fdeep%2Fdeep--v4--pro-lightgrey)
 
-- 🤖 **LLM usage:** $26.9493 (437 commits)
-- 👤 **Human dev:** ~$14971 (149.7h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $27.5767 (438 commits)
+- 👤 **Human dev:** ~$15021 (150.2h @ $100/h, 30min dedup)
 
 Generated on 2026-06-11 using [openrouter/deep/deep-v4-pro](https://openrouter.ai/deep/deep-v4-pro)
 

{koru-0.1.331.dist-info → koru-0.1.332.dist-info}/RECORD

@@ -43,7 +43,7 @@ imgl/freshness.py,sha256=DbqXzE8lN1Y8OB7nsdVcHHe1T35GxU0awB5ur2rQQx0,1652
 koru/__init__.py,sha256=Vm4rFKBrKGHWUOLhtLm2CNlqBlSmdFNWLAoz711QMqI,3535
 koru/__main__.py,sha256=UOpoyf0hO4es2XGbuRJlM7BOUxoNMA8SjLItKY7Auzc,307
 koru/activity_log.py,sha256=nZuGppo15AsE8l5hI2-z64tGFMxgV59i5FwF2c8NokY,10400
-koru/agent_backend_runtime.py,sha256=-eT3zO4a-wStByqTvIr4ycqMcGDPf4ZDla94rIdikPs,13835
+koru/agent_backend_runtime.py,sha256=Kflm3K0LdeLNUkOOr-t5vfyqTWjc2ov9zlhsr-PDr4E,15389
 koru/agent_backends.py,sha256=-QNmG7Ss_fsr8Vm2hURms_2QmrIHojKXyjfjLgLs22s,9338
 koru/agent_cli_helpers.py,sha256=EZe_qTofG84ggZgbakrFhNxsYMELKWlMf4WwbJGVBYs,2689
 koru/agents.py,sha256=fVSy0L_-PQ36FftTk3jhcjiZxz70nSKZMUHAp1ii7ig,12150
@@ -393,8 +393,8 @@ koru/ide_adapters/shared.py,sha256=duOfFoimxF8OZVcDXOKg3zW190vseEJeolkKVW2acVc,1
 koru/ide_adapters/vscode_family.py,sha256=2c6ylhiPI8-1xJHS2kJvlMmmdmpJ-b4khGkSsiJ--jI,5415
 koru/integrations/__init__.py,sha256=cddoUSXZl_lhBs1zhwht5bDwnijj7YF3WY7u1bGz4n4,406
 koru/integrations/imgl_autodiag.py,sha256=Ri2vPgzCJ6jjeyHjL3_RHnJ2F99tuCPfi5ooot4S0YE,355
-koru/integrations/imgl_client.py,sha256=6q8tsnyIcvEYdo86Ui9QQOKL4DXuAEdyzxUTg9UOLIw,10289
-koru/integrations/vdisplay_client.py,sha256=3ITjAN9ekyMV2NolEkWYb9X1DGEppd-7vKcDjAOc-Vg,32833
+koru/integrations/imgl_client.py,sha256=Nnoay8KFQcqi7u9r2JWar5fou_CtnM0wWCEYEod3Dy8,10360
+koru/integrations/vdisplay_client.py,sha256=SIKvv0UX8C-6VK4dnhpsyDzENaBi4gbsnJYIpsA4JsY,33173
 koru/queue/__init__.py,sha256=KZlgdUocyznnhtcSsK7yXDJjXPyPZIELLLI7CMWDc_o,985
 koru/queue/human.py,sha256=quuN8RC4DHXwOQMNPC3m8_PWNZDd6hZN--ZlBmY-3Bw,960
 koru/queue/koru_queue_argv.py,sha256=lH78lu7Iqzhx_DNW_llCua74AYkvc43JeEVhFPlJYtk,1235
@@ -436,7 +436,7 @@ koru/wizard/templates/library.json,sha256=6Eap1pgVjYPT8fNUIsL_dHNc9SYOCKFW3W6vxu
 koru/wizard/templates/ml-research.json,sha256=rONHc5XxKrn28qvkG8uTjwHMmA9dVIsqHEoRW9-lOtw,3484
 koru/wizard/templates/registry.json,sha256=9aiJhcO5Uq8WQT5XeUnmQTqv7GS8hYhteUS2FZSrleM,1469
 koru/wizard/templates/web-app.json,sha256=2BjQ5l4BRqcHUzAAK9_D-cT-nCfb8EqeR-l5kF7GIjg,7174
-koru-0.1.331.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+koru-0.1.332.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
 koruapi/__init__.py,sha256=9yJrfnlKhndkf5osgjhsIsvbv4kGM5w8ONgQQcOvznk,747
 koruapi/calibration_validator.py,sha256=4CWwN95cuPn7BdvIUGABjGZoJ81g2dZxcL7TfCmQufk,11733
 koruapi/cli.py,sha256=gy8GGnR9XCSv5PRGpm5J1OCjCvR-V8SY26BmE733Bok,4997
@@ -591,8 +591,8 @@ koruvision/providers/registry.py,sha256=0GPl4wjK4bP0hET2SpDJ3gkxTjLauVVBokIQXpKL
 koruvision/providers/screencast_session.py,sha256=Q8Q06Kso3jJGv3ZieG9ego1c2XwD_LjwjQ2xTI4MZMg,2087
 nlp2imgl/__init__.py,sha256=0vZk1E9F8ViPi9nK_de85HrnzoOpuQ-gzmNqrQDBVpE,95
 nlp2imgl/control.py,sha256=3QXdx8QG_HHIO2PCslTzbd-pAIjIFuWiNh36Wj4r-QY,1646
-koru-0.1.331.dist-info/METADATA,sha256=-q3cxNdNaD9Q83n0d2BvjSz8BSTECUQlJXYJLVahBmg,72766
-koru-0.1.331.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-koru-0.1.331.dist-info/entry_points.txt,sha256=nLNoiTotankEuZhByzdP0y7phHExiKc0YmLU-hQvieY,162
-koru-0.1.331.dist-info/top_level.txt,sha256=99eWAyPWuPiwn9sKJjELlg4J5XXUDCpKvuWe33nbrSk,103
-koru-0.1.331.dist-info/RECORD,,
+koru-0.1.332.dist-info/METADATA,sha256=2mQkMS1LaXrtoacYPZULLcNHnvrFw5AHG2j9OpCHMuU,72766
+koru-0.1.332.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+koru-0.1.332.dist-info/entry_points.txt,sha256=nLNoiTotankEuZhByzdP0y7phHExiKc0YmLU-hQvieY,162
+koru-0.1.332.dist-info/top_level.txt,sha256=99eWAyPWuPiwn9sKJjELlg4J5XXUDCpKvuWe33nbrSk,103
+koru-0.1.332.dist-info/RECORD,,