windhover 0.14.0__tar.gz → 0.14.1__tar.gz

{windhover-0.14.0 → windhover-0.14.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: windhover
-Version: 0.14.0
+Version: 0.14.1
 Summary: Self-hosted, mobile-friendly observability for LangGraph — traces, run history, cost, and a living graph view.
 Project-URL: Repository, https://github.com/justfeltlikerunning/windhover
 Author: justfeltlikerunning

{windhover-0.14.0 → windhover-0.14.1}/docs/GUIDE.md

@@ -60,9 +60,10 @@ Projects with a **`langgraph.json`** (the LangGraph Studio/CLI convention) need
 run `windhover` in the project directory and every graph the file defines is served.
 
 **Multiple graphs**: `WINDHOVER_GRAPH="checkout=app.flows:checkout,support=app.flows:support"`
-puts a graph selector in the top bar. The selector scopes the canvas, New run, node source,
-and Memory; the Runs page gets an extra graph filter; human-in-the-loop actions always follow
-the graph the run belongs to.
+puts a graph selector in the top bar. The selector scopes **everything** — canvas, New run,
+node source, Memory, Runs, Sessions, Stats (so per-node latency and model usage never mix
+graphs). The Runs page keeps an "All graphs" override in its own filter; human-in-the-loop
+actions always follow the graph the run belongs to.
 
 - The canvas always reflects **current-on-disk** topology (a subprocess re-extracts on
   file change). Runs, however, execute the graph **imported at startup** — restart the

{windhover-0.14.0 → windhover-0.14.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "windhover"
-version = "0.14.0"
+version = "0.14.1"
 description = "Self-hosted, mobile-friendly observability for LangGraph — traces, run history, cost, and a living graph view."
 readme = "README.md"
 requires-python = ">=3.10"

{windhover-0.14.0 → windhover-0.14.1}/tests/test_smoke.py

@@ -587,6 +587,31 @@ def test_env_multi_graph_parsing():
     print("env multi-graph parsing OK")
 
 
+def test_graph_scoped_stats_and_sessions():
+    p = tempfile.mktemp(suffix=".db")
+    s = Store(p)
+    now = int(time.time() * 1000)
+    for i, g in enumerate(("alpha", "alpha", "beta")):
+        rid = f"g{i}"
+        s.open_run({"id": rid, "graph": g, "session": f"sess-{g}", "started_ms": now - i})
+        s.add_span({"id": f"s{i}", "run_id": rid, "type": "node", "name": "shared_name",
+                    "seq": 0, "dur_ms": 100 * (i + 1)})
+        s.add_span({"id": f"l{i}", "run_id": rid, "type": "llm", "name": "m", "seq": 1,
+                    "model": f"model-{g}", "dur_ms": 5, "prompt_tokens": 10,
+                    "completion_tokens": 1})
+        s.close_run(rid, "done", now + 10)
+    st_a = s.stats(graph="alpha")
+    assert st_a["totals"]["runs"] == 2
+    assert st_a["per_node"][0]["n"] == 2            # only alpha's spans, not beta's
+    assert [m["model"] for m in st_a["models"]] == ["model-alpha"]
+    st_all = s.stats()
+    assert st_all["totals"]["runs"] == 3 and st_all["per_node"][0]["n"] == 3
+    ses_b = s.sessions(graph="beta")
+    assert [x["session"] for x in ses_b] == ["sess-beta"]
+    assert len(s.sessions()) == 2
+    print("graph-scoped stats/sessions OK")
+
+
 def test_nonblocking_sink_and_webhook_hook():
     # sink to an unreachable host must return instantly and never raise
     from windhover.tracer import http_sink
@@ -633,5 +658,6 @@ if __name__ == "__main__":
     test_message_serialization()
     test_langgraph_json_discovery()
     test_env_multi_graph_parsing()
+    test_graph_scoped_stats_and_sessions()
     test_nonblocking_sink_and_webhook_hook()
     print("ALL SMOKE TESTS PASSED")

{windhover-0.14.0 → windhover-0.14.1}/windhover/server.py

@@ -414,8 +414,8 @@ def api_runs(limit: int = 50, offset: int = 0, q: str = None, status: str = None
 
 
 @app.get("/api/sessions")
-def api_sessions(limit: int = 100):
-    return JSONResponse(store.sessions(limit=limit))
+def api_sessions(limit: int = 100, graph: str = None):
+    return JSONResponse(store.sessions(limit=limit, graph=graph or None))
 
 
 @app.get("/api/runs/{run_id}")
@@ -622,8 +622,8 @@ def api_dataset_run(ds_id: str, graph: str = None):
 
 
 @app.get("/api/stats")
-def api_stats(days: int = 30):
-    return JSONResponse(store.stats(days=max(1, min(days, 365))))
+def api_stats(days: int = 30, graph: str = None):
+    return JSONResponse(store.stats(days=max(1, min(days, 365)), graph=graph or None))
 
 
 @app.get("/api/events")

{windhover-0.14.0 → windhover-0.14.1}/windhover/static/index.html

@@ -526,7 +526,7 @@ th{font-family:var(--mono);letter-spacing:.11em;font-size:10.5px}
       </div>
       <div id="view-stats" style="display:none">
         <div class="page">
-          <div class="page-head"><h1>Stats</h1><span class="sub">all recorded runs</span></div>
+          <div class="page-head"><h1>Stats</h1><span class="sub" id="stats-sub">all recorded runs</span></div>
           <div id="stats-body"></div>
         </div>
       </div>
@@ -642,14 +642,22 @@ async function loadGraphList(){
       sel.style.display=''; $('#gname').style.display='none';
       sel.innerHTML=window.__graphList.map(g=>`<option ${g===GSEL?'selected':''}>${esc(g)}</option>`).join('');
       sel.onchange=()=>{ GSEL=sel.value; localStorage.setItem('wh-graph',GSEL);
-        loadGraph(true); probeMemory(); if(VIEW==='memory') loadMemory(); };
+        RF.graph=GSEL; const rg=$('#rgraph'); if(rg) rg.value=GSEL;
+        loadGraph(true); probeMemory();
+        if(VIEW==='memory') loadMemory();
+        if(VIEW==='runs') loadRuns();
+        if(VIEW==='sessions') loadSessions();
+        if(VIEW==='stats'){ loadStats(); loadDatasets(); } };
       const rg=$('#rgraph');
       if(rg){ rg.style.display='';
         rg.innerHTML='<option value="">All graphs</option>'+window.__graphList.map(g=>`<option>${esc(g)}</option>`).join('');
+        RF.graph=GSEL; rg.value=GSEL;
         rg.onchange=e=>{RF.graph=e.target.value;RF.offset=0;loadRuns();}; }
     }
   }catch(e){}
 }
+function multiGraph(){ return (window.__graphList||[]).length>1; }
+function gscope(){ return multiGraph()&&GSEL?'graph='+encodeURIComponent(GSEL):''; }
 function gparam(pfx){ return GSEL?pfx+'graph='+encodeURIComponent(GSEL):''; }
 function rgparam(){ const g=(window.__run||{}).graph||GSEL; return g?'graph='+encodeURIComponent(g):''; }
 let XRAY=false;
@@ -889,7 +897,7 @@ $('#rbook').onclick=()=>{RF.bookmarked=!RF.bookmarked;$('#rbook').classList.togg
 
 /* ---------- sessions ---------- */
 async function loadSessions(){
-  const ss=await(await fetch('/api/sessions')).json();
+  const ss=await(await fetch('/api/sessions?'+gscope())).json();
   $('#sess-sub').textContent=ss.length?`${ss.length} session${ss.length===1?'':'s'}`:'';
   if(!ss.length){ $('#sess-wrap').innerHTML='<div class="empty"><div class="t">No sessions yet</div>Pass <span class="mono">session=</span> to <span class="mono">WindhoverTracer</span>, or <span class="mono">config={"metadata": {"windhover_session": …}}</span> in any LangChain/LangGraph app.</div>'; return; }
   $('#sess-wrap').innerHTML=`<div style="overflow:auto"><table>
@@ -1178,11 +1186,13 @@ function chartCard(title,daily,val,errKey){
     <div class="clabels"><span>${daily[0]?.day||''}</span><span>${daily[daily.length-1]?.day||''}</span></div></div></div>`;
 }
 async function loadStats(){
-  const s=await(await fetch('/api/stats?days=30')).json(); const t=s.totals||{};
+  const s=await(await fetch('/api/stats?days=30&'+gscope())).json(); const t=s.totals||{};
   const errRate=t.runs?Math.round((t.errors||0)/t.runs*100):0;
   const max=Math.max(1,...(s.per_node||[]).map(n=>n.avg_ms||0));
   const daily=s.daily||[], models=s.models||[];
   const db=t.db_bytes!=null?(t.db_bytes/1048576).toFixed(1)+' MB db':'';
+  const ssub=document.getElementById('stats-sub');
+  if(ssub) ssub.textContent=(multiGraph()&&GSEL)?('graph: '+GSEL):'all recorded runs';
   $('#stats-body').innerHTML=`
     <div class="metrics">
       <div class="metric"><div class="v num">${t.runs||0}</div><div class="l">Total runs</div></div>

{windhover-0.14.0 → windhover-0.14.1}/windhover/store.py

@@ -310,14 +310,18 @@ class Store:
                     r["scores"] = sc.get(r["id"]) or None
         return {"runs": rows, "total": total, "limit": limit, "offset": offset}
 
-    def sessions(self, limit: int = 100) -> list[dict]:
+    def sessions(self, limit: int = 100, graph: Optional[str] = None) -> list[dict]:
+        cond, args = "", []
+        if graph:
+            cond = " AND graph=?"; args.append(graph)
         with _lock, self._conn() as c:
-            return [dict(r) for r in c.execute("""SELECT session,
+            return [dict(r) for r in c.execute(f"""SELECT session,
                 COUNT(*) runs, COUNT(*) FILTER (WHERE status='error') errors,
                 MIN(started_ms) first_ms, MAX(started_ms) last_ms,
                 SUM(total_tokens) tokens, SUM(cost_usd) cost, SUM(duration_ms) duration_ms
-                FROM runs WHERE session IS NOT NULL AND session!=''
-                GROUP BY session ORDER BY last_ms DESC LIMIT ?""", (limit,)).fetchall()]
+                FROM runs WHERE session IS NOT NULL AND session!=''{cond}
+                GROUP BY session ORDER BY last_ms DESC LIMIT ?""",
+                (*args, limit)).fetchall()]
 
     def run_detail(self, run_id: str) -> Optional[dict]:
         with _lock, self._conn() as c:
@@ -366,27 +370,36 @@ class Store:
                     s[f] = json.loads(s[f]) if s.get(f) else None
         return {"name": name, "summary": dict(agg), "recent": rows}
 
-    def stats(self, days: int = 30) -> dict:
+    def stats(self, days: int = 30, graph: Optional[str] = None) -> dict:
         cutoff = int((time.time() - days * 86400) * 1000)
+        rcond, rargs = ("", [])
+        scond, sargs = ("", [])
+        if graph:
+            rcond = " WHERE graph=?"; rargs = [graph]
+            scond = " AND runs.graph=?"; sargs = [graph]
         with _lock, self._conn() as c:
-            tot = c.execute("""SELECT COUNT(*) runs,
+            tot = c.execute(f"""SELECT COUNT(*) runs,
                 COUNT(*) FILTER (WHERE status='error') errors,
                 SUM(total_tokens) tokens, SUM(cost_usd) cost,
-                SUM(llm_calls) llm_calls FROM runs""").fetchone()
-            per_node = c.execute("""SELECT name, COUNT(*) n, AVG(dur_ms) avg_ms,
-                SUM(cost_usd) cost FROM spans WHERE type='node'
-                GROUP BY name ORDER BY avg_ms DESC LIMIT 20""").fetchall()
-            models = c.execute("""SELECT model, COUNT(*) calls,
-                SUM(prompt_tokens) prompt_tokens, SUM(completion_tokens) completion_tokens,
-                SUM(cost_usd) cost, AVG(dur_ms) avg_ms
-                FROM spans WHERE type='llm' AND model IS NOT NULL
-                GROUP BY model ORDER BY calls DESC LIMIT 20""").fetchall()
-            daily = c.execute("""SELECT
+                SUM(llm_calls) llm_calls FROM runs{rcond}""", rargs).fetchone()
+            per_node = c.execute(f"""SELECT spans.name, COUNT(*) n,
+                AVG(spans.dur_ms) avg_ms, SUM(spans.cost_usd) cost
+                FROM spans JOIN runs ON runs.id = spans.run_id
+                WHERE spans.type='node'{scond}
+                GROUP BY spans.name ORDER BY avg_ms DESC LIMIT 20""", sargs).fetchall()
+            models = c.execute(f"""SELECT spans.model, COUNT(*) calls,
+                SUM(spans.prompt_tokens) prompt_tokens,
+                SUM(spans.completion_tokens) completion_tokens,
+                SUM(spans.cost_usd) cost, AVG(spans.dur_ms) avg_ms
+                FROM spans JOIN runs ON runs.id = spans.run_id
+                WHERE spans.type='llm' AND spans.model IS NOT NULL{scond}
+                GROUP BY spans.model ORDER BY calls DESC LIMIT 20""", sargs).fetchall()
+            daily = c.execute(f"""SELECT
                 strftime('%Y-%m-%d', started_ms/1000, 'unixepoch') day,
                 COUNT(*) runs, COUNT(*) FILTER (WHERE status='error') errors,
                 SUM(total_tokens) tokens, SUM(cost_usd) cost
-                FROM runs WHERE started_ms >= ?
-                GROUP BY day ORDER BY day""", (cutoff,)).fetchall()
+                FROM runs WHERE started_ms >= ?{' AND graph=?' if graph else ''}
+                GROUP BY day ORDER BY day""", (cutoff, *rargs)).fetchall()
         try:
             db_bytes = os.path.getsize(self.path)
         except OSError:
@@ -395,4 +408,4 @@ class Store:
                 "per_node": [dict(r) for r in per_node],
                 "models": [dict(r) for r in models],
                 "daily": [dict(r) for r in daily],
-                "days": days}
+                "days": days, "graph": graph}