koru 0.1.331__tar.gz → 0.1.332__tar.gz

{koru-0.1.331/src/koru.egg-info → koru-0.1.332}/PKG-INFO

@@ -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 → koru-0.1.332}/README.md

@@ -7,11 +7,11 @@
 
 ## 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 → koru-0.1.332}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "koru"
-version = "0.1.331"
+version = "0.1.332"
 description = "Closed-loop automation across semcod/* repositories."
 readme = "README.md"
 requires-python = ">=3.12,<3.14"

{koru-0.1.331 → koru-0.1.332}/src/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-0.1.331 → koru-0.1.332}/src/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-0.1.331 → koru-0.1.332}/src/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 → koru-0.1.332/src/koru.egg-info}/PKG-INFO

@@ -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)