graphsight 0.1.4__tar.gz → 0.2.0__tar.gz

{graphsight-0.1.4/graphsight.egg-info → graphsight-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphsight
-Version: 0.1.4
+Version: 0.2.0
 Summary: See why your AI agent retrieved what it did — interactive graph viewer for agent retrieval traces. One command, zero dependencies, nothing leaves your machine.
 Author: Arush Karnatak
 License: MIT
@@ -69,12 +69,43 @@ graphsight [trace] [--port PORT] [--no-browser]
 
 | Argument | Default | Description |
 |---|---|---|
-| `trace` | — | Path to a `trace_state.json`. Optional — omit to open the import page and drag-and-drop or paste JSON instead. |
+| `trace` | — | A `trace_state.json` file, **or a directory of them** (e.g. `.graphsight/`) to browse run history. Optional — omit to open the import page and drag-and-drop or paste JSON instead. |
 | `--port` | `4630` | Local port to serve on. |
 | `--no-browser` | off | Start the server without opening a browser window. |
 
 The server binds to `127.0.0.1` only and runs until you press `Ctrl+C`.
 
+## Run history
+
+Point `graphsight` at a directory and it becomes a run browser — every
+trace listed by query and time, one click to open:
+
+```bash
+graphsight .graphsight/
+```
+
+The [graphsight-langgraph](https://pypi.org/project/graphsight-langgraph/)
+`capture()` helper appends every agent run there automatically, so your
+debugging history accumulates with zero ceremony. Traces render with the
+**retrieved vs. used** split: items that surfaced in the answer highlighted,
+items retrieved but ignored dimmed — the two classic retrieval failures,
+visible at a glance.
+
+## Sharing traces with your team
+
+A trace is one self-contained JSON file — no account or backend needed to
+share it:
+
+- **Send the file.** A teammate with `graphsight` installed runs
+  `graphsight trace.json`. Works in a DM, a ticket attachment, a CI
+  artifact.
+- **Link it.** A deployed Graphsight frontend opens any publicly reachable
+  trace via `…/memory/import?src=<url-to-json>` — host the JSON on a gist
+  or artifact store and share the link. (The host must allow cross-origin
+  GETs; raw gists do.)
+- **Commit it.** Trace files in the repo next to the incident or PR they
+  explain make retrieval debugging part of the review record.
+
 ## Producing traces
 
 Graphsight renders any file matching its trace JSON contract. Current

{graphsight-0.1.4 → graphsight-0.2.0}/README.md

@@ -45,12 +45,43 @@ graphsight [trace] [--port PORT] [--no-browser]
 
 | Argument | Default | Description |
 |---|---|---|
-| `trace` | — | Path to a `trace_state.json`. Optional — omit to open the import page and drag-and-drop or paste JSON instead. |
+| `trace` | — | A `trace_state.json` file, **or a directory of them** (e.g. `.graphsight/`) to browse run history. Optional — omit to open the import page and drag-and-drop or paste JSON instead. |
 | `--port` | `4630` | Local port to serve on. |
 | `--no-browser` | off | Start the server without opening a browser window. |
 
 The server binds to `127.0.0.1` only and runs until you press `Ctrl+C`.
 
+## Run history
+
+Point `graphsight` at a directory and it becomes a run browser — every
+trace listed by query and time, one click to open:
+
+```bash
+graphsight .graphsight/
+```
+
+The [graphsight-langgraph](https://pypi.org/project/graphsight-langgraph/)
+`capture()` helper appends every agent run there automatically, so your
+debugging history accumulates with zero ceremony. Traces render with the
+**retrieved vs. used** split: items that surfaced in the answer highlighted,
+items retrieved but ignored dimmed — the two classic retrieval failures,
+visible at a glance.
+
+## Sharing traces with your team
+
+A trace is one self-contained JSON file — no account or backend needed to
+share it:
+
+- **Send the file.** A teammate with `graphsight` installed runs
+  `graphsight trace.json`. Works in a DM, a ticket attachment, a CI
+  artifact.
+- **Link it.** A deployed Graphsight frontend opens any publicly reachable
+  trace via `…/memory/import?src=<url-to-json>` — host the JSON on a gist
+  or artifact store and share the link. (The host must allow cross-origin
+  GETs; raw gists do.)
+- **Commit it.** Trace files in the repo next to the incident or PR they
+  explain make retrieval debugging part of the review record.
+
 ## Producing traces
 
 Graphsight renders any file matching its trace JSON contract. Current

{graphsight-0.1.4 → graphsight-0.2.0}/graphsight/__init__.py

@@ -8,4 +8,4 @@ Serves the bundled Graphsight Studio UI locally and opens the trace in the
 browser. No backend, no accounts, no network calls beyond localhost.
 """
 
-__version__ = "0.1.4"
+__version__ = "0.2.0"

{graphsight-0.1.4 → graphsight-0.2.0}/graphsight/cli.py

@@ -1,4 +1,4 @@
-"""graphsight CLI — open a trace in the bundled Studio UI."""
+"""graphsight CLI — open a trace (or a whole run history) in the bundled UI."""
 from __future__ import annotations
 
 import argparse
@@ -7,7 +7,7 @@ import webbrowser
 from pathlib import Path
 from typing import Optional
 
-from .server import TRACE_ROUTE, make_server
+from .server import RUNS_ROUTE, TRACE_ROUTE, make_server
 
 
 def main(argv: Optional[list[str]] = None) -> None:
@@ -19,26 +19,38 @@ def main(argv: Optional[list[str]] = None) -> None:
 
     parser = argparse.ArgumentParser(
         prog="graphsight",
-        description="Serve the Graphsight Studio locally and open a trace_state.json in it.",
+        description="Open a trace_state.json — or a history directory like .graphsight/ — in your browser.",
     )
     parser.add_argument("trace", nargs="?", type=Path,
-                        help="path to a trace_state.json (optional — omit to open the import page)")
+                        help="a trace_state.json, or a directory of them (e.g. .graphsight/); "
+                             "omit to open the import page")
     parser.add_argument("--port", type=int, default=4630, help="port to serve on (default 4630)")
     parser.add_argument("--no-browser", action="store_true", help="don't open the browser")
     args = parser.parse_args(argv)
 
-    trace_path = args.trace.resolve() if args.trace else None
-    if trace_path is not None and not trace_path.is_file():
-        parser.error(f"trace file not found: {trace_path}")
+    trace_path: Optional[Path] = None
+    history_dir: Optional[Path] = None
+    if args.trace is not None:
+        target = args.trace.resolve()
+        if target.is_dir():
+            history_dir = target
+        elif target.is_file():
+            trace_path = target
+        else:
+            parser.error(f"not found: {target}")
 
-    server = make_server(args.port, trace_path)
+    server = make_server(args.port, trace_path=trace_path, history_dir=history_dir)
     url = f"http://127.0.0.1:{args.port}/memory/import"
     if trace_path is not None:
         url += f"?src={TRACE_ROUTE}"
+    elif history_dir is not None:
+        url += f"?runs={RUNS_ROUTE}"
 
     print(f"graphsight serving at {url}")
     if trace_path is not None:
         print(f"trace: {trace_path}")
+    if history_dir is not None:
+        print(f"history: {history_dir}")
     print("Ctrl+C to stop")
     if not args.no_browser:
         webbrowser.open(url)

graphsight-0.1.4/graphsight/dist/assets/arc-CmG4qZOi.js → graphsight-0.2.0/graphsight/dist/assets/arc-DX2Y_03-.js

@@ -1 +1 @@
-import{$ as ln,a0 as an,a1 as G,a2 as q,a3 as z,a4 as un,a5 as y,a6 as tn,a7 as K,a8 as _,a9 as rn,aa as o,ab as on,ac as sn,ad as fn}from"./mermaid.core-CiFNaHpi.js";function cn(l){return l.innerRadius}function yn(l){return l.outerRadius}function gn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,I,D,v,A,B,a){var O=I-l,i=D-h,n=B-v,d=a-A,u=d*O-n*i;if(!(u*u<y))return u=(n*(h-A)-d*(l-v))/u,[l+u*O,h+u*i]}function V(l,h,I,D,v,A,B){var a=l-I,O=h-D,i=(B?A:-A)/K(a*a+O*O),n=i*O,d=-i*a,u=l+n,s=h+d,f=I+n,c=D+d,C=(u+f)/2,t=(s+c)/2,m=f-u,g=c-s,R=m*m+g*g,T=v-A,P=u*c-f*s,S=(g<0?-1:1)*K(on(0,T*T*R-P*P)),$=(P*g-m*S)/R,j=(-P*m-g*S)/R,w=(P*g+m*S)/R,p=(-P*m+g*S)/R,x=$-C,e=j-t,r=w-C,F=p-t;return x*x+e*e>r*r+F*F&&($=w,j=p),{cx:$,cy:j,x01:-n,y01:-d,x11:$*(v/T-1),y11:j*(v/T-1)}}function hn(){var l=cn,h=yn,I=z(0),D=null,v=gn,A=dn,B=mn,a=null,O=ln(i);function i(){var n,d,u=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-un,c=A.apply(this,arguments)-un,C=rn(c-f),t=c>f;if(a||(a=n=O()),s<u&&(d=s,s=u,u=d),!(s>y))a.moveTo(0,0);else if(C>tn-y)a.moveTo(s*G(f),s*q(f)),a.arc(0,0,s,f,c,!t),u>y&&(a.moveTo(u*G(c),u*q(c)),a.arc(0,0,u,c,f,t));else{var m=f,g=c,R=f,T=c,P=C,S=C,$=B.apply(this,arguments)/2,j=$>y&&(D?+D.apply(this,arguments):K(u*u+s*s)),w=_(rn(s-u)/2,+I.apply(this,arguments)),p=w,x=w,e,r;if(j>y){var F=sn(j/u*q($)),L=sn(j/s*q($));(P-=F*2)>y?(F*=t?1:-1,R+=F,T-=F):(P=0,R=T=(f+c)/2),(S-=L*2)>y?(L*=t?1:-1,m+=L,g-=L):(S=0,m=g=(f+c)/2)}var H=s*G(m),J=s*q(m),M=u*G(T),N=u*q(T);if(w>y){var Q=s*G(g),U=s*q(g),W=u*G(R),X=u*q(R),E;if(C<an)if(E=pn(H,J,W,X,Q,U,M,N)){var Y=H-E[0],Z=J-E[1],b=Q-E[0],k=U-E[1],nn=1/q(fn((Y*b+Z*k)/(K(Y*Y+Z*Z)*K(b*b+k*k)))/2),en=K(E[0]*E[0]+E[1]*E[1]);p=_(w,(u-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}S>y?x>y?(e=V(W,X,H,J,s,x,t),r=V(Q,U,M,N,s,x,t),a.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),a.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(a.moveTo(H,J),a.arc(0,0,s,m,g,!t)):a.moveTo(H,J),!(u>y)||!(P>y)?a.lineTo(M,N):p>y?(e=V(M,N,Q,U,u,-p,t),r=V(H,J,W,X,u,-p,t),a.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,u,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),a.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):a.arc(0,0,u,T,R,t)}if(a.closePath(),n)return a=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-an/2;return[G(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:z(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:z(+n),i):h},i.cornerRadius=function(n){return arguments.length?(I=typeof n=="function"?n:z(+n),i):I},i.padRadius=function(n){return arguments.length?(D=n==null?null:typeof n=="function"?n:z(+n),i):D},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:z(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:z(+n),i):A},i.padAngle=function(n){return arguments.length?(B=typeof n=="function"?n:z(+n),i):B},i.context=function(n){return arguments.length?(a=n??null,i):a},i}export{hn as d};
+import{$ as ln,a0 as an,a1 as G,a2 as q,a3 as z,a4 as un,a5 as y,a6 as tn,a7 as K,a8 as _,a9 as rn,aa as o,ab as on,ac as sn,ad as fn}from"./mermaid.core-B77A9b3a.js";function cn(l){return l.innerRadius}function yn(l){return l.outerRadius}function gn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,I,D,v,A,B,a){var O=I-l,i=D-h,n=B-v,d=a-A,u=d*O-n*i;if(!(u*u<y))return u=(n*(h-A)-d*(l-v))/u,[l+u*O,h+u*i]}function V(l,h,I,D,v,A,B){var a=l-I,O=h-D,i=(B?A:-A)/K(a*a+O*O),n=i*O,d=-i*a,u=l+n,s=h+d,f=I+n,c=D+d,C=(u+f)/2,t=(s+c)/2,m=f-u,g=c-s,R=m*m+g*g,T=v-A,P=u*c-f*s,S=(g<0?-1:1)*K(on(0,T*T*R-P*P)),$=(P*g-m*S)/R,j=(-P*m-g*S)/R,w=(P*g+m*S)/R,p=(-P*m+g*S)/R,x=$-C,e=j-t,r=w-C,F=p-t;return x*x+e*e>r*r+F*F&&($=w,j=p),{cx:$,cy:j,x01:-n,y01:-d,x11:$*(v/T-1),y11:j*(v/T-1)}}function hn(){var l=cn,h=yn,I=z(0),D=null,v=gn,A=dn,B=mn,a=null,O=ln(i);function i(){var n,d,u=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-un,c=A.apply(this,arguments)-un,C=rn(c-f),t=c>f;if(a||(a=n=O()),s<u&&(d=s,s=u,u=d),!(s>y))a.moveTo(0,0);else if(C>tn-y)a.moveTo(s*G(f),s*q(f)),a.arc(0,0,s,f,c,!t),u>y&&(a.moveTo(u*G(c),u*q(c)),a.arc(0,0,u,c,f,t));else{var m=f,g=c,R=f,T=c,P=C,S=C,$=B.apply(this,arguments)/2,j=$>y&&(D?+D.apply(this,arguments):K(u*u+s*s)),w=_(rn(s-u)/2,+I.apply(this,arguments)),p=w,x=w,e,r;if(j>y){var F=sn(j/u*q($)),L=sn(j/s*q($));(P-=F*2)>y?(F*=t?1:-1,R+=F,T-=F):(P=0,R=T=(f+c)/2),(S-=L*2)>y?(L*=t?1:-1,m+=L,g-=L):(S=0,m=g=(f+c)/2)}var H=s*G(m),J=s*q(m),M=u*G(T),N=u*q(T);if(w>y){var Q=s*G(g),U=s*q(g),W=u*G(R),X=u*q(R),E;if(C<an)if(E=pn(H,J,W,X,Q,U,M,N)){var Y=H-E[0],Z=J-E[1],b=Q-E[0],k=U-E[1],nn=1/q(fn((Y*b+Z*k)/(K(Y*Y+Z*Z)*K(b*b+k*k)))/2),en=K(E[0]*E[0]+E[1]*E[1]);p=_(w,(u-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}S>y?x>y?(e=V(W,X,H,J,s,x,t),r=V(Q,U,M,N,s,x,t),a.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),a.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(a.moveTo(H,J),a.arc(0,0,s,m,g,!t)):a.moveTo(H,J),!(u>y)||!(P>y)?a.lineTo(M,N):p>y?(e=V(M,N,Q,U,u,-p,t),r=V(H,J,W,X,u,-p,t),a.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,u,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),a.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):a.arc(0,0,u,T,R,t)}if(a.closePath(),n)return a=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-an/2;return[G(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:z(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:z(+n),i):h},i.cornerRadius=function(n){return arguments.length?(I=typeof n=="function"?n:z(+n),i):I},i.padRadius=function(n){return arguments.length?(D=n==null?null:typeof n=="function"?n:z(+n),i):D},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:z(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:z(+n),i):A},i.padAngle=function(n){return arguments.length?(B=typeof n=="function"?n:z(+n),i):B},i.context=function(n){return arguments.length?(a=n??null,i):a},i}export{hn as d};