koru 0.1.330__tar.gz → 0.1.332__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: koru
-Version: 0.1.330
+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.330-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.94-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-149.1h-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.9381 (436 commits)
-- 👤 **Human dev:** ~$14912 (149.1h @ $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.330 → 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.330-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.94-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-149.1h-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.9381 (436 commits)
-- 👤 **Human dev:** ~$14912 (149.1h @ $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.330 → koru-0.1.332}/pyproject.toml

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

{koru-0.1.330 → 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.330 → koru-0.1.332}/src/koru/autonomous_cycle_drive_retry.py

@@ -347,6 +347,17 @@ def _invoke_client_autopilot_drive(
     ok = bool(reply.get("ok", True))
     if ok or require_plugin:
         return reply, ok
+    # Prefer vdisplay semantic control (with VQL click_centers, vision, resolve fallback)
+    # for non-plugin lanes like jetbrains when available (Wayland, KORU_VDISPLAY_...=1)
+    vdisplay = _try_vdisplay_control_fallback(
+        prompt,
+        submit=submit,
+        ide=autopilot_ide,
+        project=project,
+        plugin_connected=bool(reply.get("ok")),
+    )
+    if vdisplay is not None and vdisplay.get("ok"):
+        return vdisplay, True
     imgl = _try_imgl_gui_fallback(
         prompt,
         submit=submit,
@@ -363,15 +374,6 @@ def _invoke_client_autopilot_drive(
     )
     if gillm is not None and gillm.get("ok"):
         return gillm, True
-    vdisplay = _try_vdisplay_control_fallback(
-        prompt,
-        submit=submit,
-        ide=autopilot_ide,
-        project=project,
-        plugin_connected=bool(reply.get("ok")),
-    )
-    if vdisplay is not None and vdisplay.get("ok"):
-        return vdisplay, True
     nlp2uri_focus = _try_nlp2uri_focus_fallback(prompt, submit=submit, ide=autopilot_ide)
     if nlp2uri_focus is not None and nlp2uri_focus.get("ok"):
         return nlp2uri_focus, True

{koru-0.1.330 → koru-0.1.332}/src/koru/autonomous_cycle_gate.py

@@ -263,9 +263,32 @@ def try_vdisplay_control_fallback(
 
     if not vdisplay_fallback_enabled(ide=ide, plugin_connected=plugin_connected):
         return None
+    # Ensure session for audit/recovery when using vdisplay (addresses gap in auto runner not setting VDISPLAY_SESSION)
+    os.environ.setdefault("VDISPLAY_SESSION", "1")
     try:
+        # Load VQL metadata (our analysis or fresh per-screenshot) to provide
+        # click_center / data_locations / decision_data for semantic actions.
+        # This gives the autonomy loop precise mouse coords and "where the data is"
+        # (pngs, client code, .env LLM, planfile) for decisions in JetBrains/Cursor.
+        from koru.integrations.vdisplay_client import load_vql_metadata, record_koru_drive_step
+        vql = load_vql_metadata()
+        vql_note = ""
+        if vql.get("ui_elements"):
+            cc = vql["ui_elements"][0].get("click_center", {})
+            vql_note = f" VQL click_center={cc} (use for editor focus / chat in IDE)"
         reply = send_chat(prompt, ide=ide, submit=submit)
         reply.setdefault("fallback_from", "plugin")
+        reply.setdefault("vql_context", vql.get("_source") or "loaded")
+        if vql_note:
+            reply["vql_note"] = vql_note
+        # Record to vdisplay session for audit trail (P1)
+        try:
+            record_koru_drive_step(reply, profile_id=ide, text=prompt)
+        except Exception:
+            pass
+        # If the drive used vdisplay, autonomy can now use the coords from VQL
+        # (e.g. resolve_click_for_frame or the centers from fresh 31-elem captures)
+        # instead of blind keyboard.
         return reply
     except Exception as exc:
         return {

{koru-0.1.330 → 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.330 → koru-0.1.332}/src/koru/integrations/vdisplay_client.py

@@ -7,6 +7,7 @@ automation: AT-SPI / Playwright / terminal / X11 / vision routing with verify.
 
 from __future__ import annotations
 
+import json
 import os
 import urllib.error
 import urllib.request
@@ -435,6 +436,7 @@ def _find_first_selector(
     ide: str,
     selectors: tuple[dict[str, str], ...],
     backend: str = "auto",
+    vql_fallback: bool = True,
 ) -> tuple[dict[str, str] | None, dict[str, Any] | None]:
     hints = _ide_hints(ide)
     base = {
@@ -453,6 +455,27 @@ def _find_first_selector(
         if found.get("ok") and int(found.get("count") or 0) > 0:
             return spec, found
         last_error = found
+
+    # VQL fallback: if vision found nothing, use explicit click_center from loaded VQL
+    # (fresh 31-elem capture or our analysis with decision_data + mouse coords for JetBrains/Cursor)
+    if vql_fallback:
+        vql = load_vql_metadata()
+        if vql.get("ui_elements"):
+            cc = vql["ui_elements"][0].get("click_center", {})
+            if cc:
+                return None, {
+                    "ok": True,
+                    "count": 1,
+                    "selected": {
+                        "id": "vql-fallback:0",
+                        "backend": "vql",
+                        "role": "unknown",
+                        "name": "vql-center",
+                        "click_point": {"x": cc.get("x"), "y": cc.get("y")},
+                        "note": f"VQL fallback center from {vql.get('_source')}"
+                    },
+                    "matches": [{"id": "vql-fallback:0", "click_center": cc}]
+                }
     return None, last_error
 
 
@@ -596,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:
@@ -645,17 +690,21 @@ def send_chat(
 
     selector, found = _find_first_selector(ide=ide, selectors=_chat_selectors_for(ide))
     if selector is None:
-        return {
-            "ok": False,
-            "backend": "vdisplay",
-            "message": (
-                f"no chat input matched for ide={ide} "
-                f"(app={hints.get('app')!r}); focus_error={focus_error or '-'}"
-            ),
-            "type": "error",
-            "fallback_from": "plugin",
-            "diagnostics": found,
-        }
+        found = _resolve_vql_chat_target(ide, hints)
+        if found:
+            selector = {"role": "input", "name_contains": "Chat"}
+        else:
+            return {
+                "ok": False,
+                "backend": "vdisplay",
+                "message": (
+                    f"no chat input matched for ide={ide} "
+                    f"(app={hints.get('app')!r}); focus_error={focus_error or '-'}"
+                ),
+                "type": "error",
+                "fallback_from": "plugin",
+                "diagnostics": found,
+            }
 
     write_kwargs = {
         "backend": "auto",
@@ -733,6 +782,129 @@ def send_chat(
     }
 
 
+def load_vql_metadata(path: str | None = None) -> dict:
+    """Load VQL metadata (from .vdisplay/2026-06-11-vql-metadata-analysis-previous-current.json or per-capture .vql.json).
+    Returns ui_elements with click_center, data_locations, decision_data etc for mouse nav + decide.
+    Used to augment vision/control with explicit coords and data sources from previous/current analysis.
+    Now also falls back to latest fresh capture VQL (e.g. koru-cont-*.vql.json) for up-to-date 30+ element bboxes/centers.
+    Always normalizes to have 'layers' alias for ui_elements for compatibility with VQL consumers expecting layers.
+    """
+    candidates = []
+    if path:
+        candidates.append(path)
+    else:
+        candidates += [
+            ".vdisplay/2026-06-11-vql-metadata-analysis-previous-current.json",
+            ".vdisplay/koru-cont-dp1-*.png.vql.json",  # glob handled below
+            "/tmp/koru-cont-dp1-*.png.vql.json",
+            "/tmp/vdisplay-auto-observe-auto-vision-find-cursor.png.vql.json",
+        ]
+    for cand in candidates:
+        try:
+            import glob
+            if "*" in cand:
+                matches = sorted(glob.glob(cand), reverse=True)
+                if not matches: continue
+                cand = matches[0]
+            if not os.path.exists(cand): continue
+            with open(cand) as f:
+                data = json.load(f)
+            # Normalize various VQL structures (analysis, fresh capture from screenshot, imgl, etc.)
+            if "ui_elements" in data and data.get("ui_elements"):
+                data["_source"] = cand
+                if "layers" not in data:
+                    data["layers"] = data["ui_elements"]
+                return data
+            if "elements" in data and isinstance(data.get("elements"), list) and data["elements"]:
+                # Fresh per-capture .vql.json from screenshot (top-level elements + by_role + element_count)
+                ui_els = []
+                for e in data["elements"]:
+                    bbox = e.get("bbox") or [0,0,0,0]
+                    if isinstance(bbox, (list, tuple)) and len(bbox) >= 4:
+                        cx = (bbox[0] + bbox[2]) / 2
+                        cy = (bbox[1] + bbox[3]) / 2
+                    else:
+                        c = e.get("center") or [1024, 640]
+                        cx, cy = (c if isinstance(c, (list,tuple)) else [1024,640])[:2]
+                    ui_els.append({
+                        "id": str(e.get("id", f"elem-{len(ui_els)}")),
+                        "role": e.get("role", "unknown"),
+                        "bounds": {"x": int(bbox[0]), "y": int(bbox[1]), "width": int(bbox[2]-bbox[0]) if len(bbox)>2 else 0, "height": int(bbox[3]-bbox[1]) if len(bbox)>3 else 0, "coordinate_space": "capture_frame_local"},
+                        "click_center": {"x": int(cx), "y": int(cy), "note": f"fresh VQL elem, color={e.get('color')}, conf={e.get('confidence')}"},
+                        "label": e.get("label"),
+                        "metadata": {k: e.get(k) for k in ("color","confidence","location") if k in e}
+                    })
+                res = {"ui_elements": ui_els, "layers": ui_els, "element_count": data.get("element_count", len(ui_els)), "by_role": data.get("by_role", {}), "scene": data.get("scene"), "_source": cand, "raw_fresh": True}
+                return res
+            if "vql" in data and isinstance(data.get("vql"), dict):
+                prog = data["vql"].get("program", data["vql"])
+                if isinstance(prog, dict):
+                    prog["_source"] = cand
+                    if "layers" not in prog and "ui_elements" in prog:
+                        prog["layers"] = prog["ui_elements"]
+                    return prog
+            if "screen_context" in data or "metadata" in data:
+                return {"ui_elements": [], "layers": [], "metadata": data.get("metadata", data.get("screen_context", {})), "environment": data.get("environment", {}), "_source": cand}
+            if isinstance(data.get("program"), (str, dict)) and "elements" not in data:
+                data["_source"] = cand
+                if "layers" not in data:
+                    data["layers"] = data.get("ui_elements", [])
+                return data
+            data["_source"] = cand
+            if "layers" not in data:
+                data["layers"] = data.get("ui_elements", [])
+            return data
+        except Exception as exc:
+            continue
+    return {"error": "no vql found", "tried": candidates, "layers": [], "ui_elements": []}
+
+
+def get_vql_target(ide: str, *, role: str | None = None, name_contains: str | None = None, label: str | None = None) -> dict | None:
+    """Select target from loaded VQL ui_elements/layers by role or name/label.
+    Returns dict with click_center, bounds, id for use in act (mouse nav).
+    Used to close observe -> decide -> act gap when vision stub or no map.
+    """
+    vql = load_vql_metadata()
+    targets = vql.get("ui_elements") or vql.get("layers") or []
+    for t in targets:
+        if role and t.get("role") != role:
+            continue
+        if name_contains and name_contains.lower() not in str(t.get("label", "")).lower() and name_contains.lower() not in str(t.get("id", "")).lower():
+            continue
+        if label and label.lower() not in str(t.get("label", "")).lower():
+            continue
+        cc = t.get("click_center") or {}
+        if cc:
+            return {
+                "id": t.get("id"),
+                "role": t.get("role"),
+                "click_center": cc,
+                "bounds": t.get("bounds"),
+                "source": vql.get("_source"),
+            }
+    return None
+
+
+def resolve_click_for_frame(source: str = "DP-1", vql_path: str | None = None, vision_fallback: bool = True) -> dict:
+    """Helper: return best click coords for a monitor/frame.
+    Prefers explicit from load_vql_metadata (fresh capture or analysis).
+    Can be used when vision find returns no match (e.g. "planfile" anchor) as general editor/center action.
+    """
+    m = load_vql_metadata(vql_path)
+    if m.get("ui_elements"):
+        # Prefer first (usually the main capture frame for --source)
+        for el in m.get("ui_elements", []):
+            if source.lower() in str(el.get("source", "")).lower() or "dp-1" in str(el).lower() or not el.get("source"):
+                if cc := el.get("click_center"):
+                    return {"x": cc.get("x"), "y": cc.get("y"), "source": m.get("_source"), "note": el.get("note", "from VQL")}
+        # fallback any
+        el = m["ui_elements"][0]
+        if cc := el.get("click_center") or el.get("center"):
+            return {"x": cc.get("x") if isinstance(cc, dict) else cc[0], "y": cc.get("y") if isinstance(cc, dict) else cc[1], "source": m.get("_source")}
+    # last resort frame center for 2048x1280 DP-1 crop
+    return {"x": 1024, "y": 640, "source": "hardcoded-fallback", "note": "DP-1 capture frame center"}
+
+
 __all__ = [
     "send_chat",
     "send_chat_via_ide_prompt",
@@ -740,4 +912,7 @@ __all__ = [
     "vdisplay_available",
     "vdisplay_fallback_enabled",
     "vdisplay_missing_message",
+    "load_vql_metadata",
+    "get_vql_target",
+    "resolve_click_for_frame",
 ]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: koru
-Version: 0.1.330
+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.330-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.94-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-149.1h-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.9381 (436 commits)
-- 👤 **Human dev:** ~$14912 (149.1h @ $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)