graphsight 0.1.0__tar.gz → 0.1.2__tar.gz

graphsight-0.1.2/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: graphsight
+Version: 0.1.2
+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
+Project-URL: Repository, https://github.com/Kcodess2807/graphsight
+Project-URL: Documentation, https://github.com/Kcodess2807/graphsight/tree/main/graphsight
+Keywords: tracing,observability,rag,retrieval,agents,visualization,langgraph
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# graphsight
+
+[![PyPI](https://img.shields.io/pypi/v/graphsight.svg)](https://pypi.org/project/graphsight/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://pypi.org/project/graphsight/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://github.com/Kcodess2807/graphsight/blob/main/graphsight/LICENSE)
+
+**See exactly why your AI agent retrieved what it did.**
+
+Your agent answered a question. Which documents did it actually pull? What
+scores did they get? How are they connected to each other? Most stacks make
+you dig through logs to answer that. Graphsight renders the run as an
+**interactive graph in your browser** — one command, zero dependencies,
+nothing leaves your machine.
+
+```bash
+pip install graphsight
+graphsight path/to/trace_state.json
+```
+
+## What you get
+
+- **Every retrieved item as a typed node** — PR, Service, Person, Ticket,
+  Document, Repo, Library, Team, Tool — with its retrieval score.
+- **Relational paths between results** — *person → authored → PR →
+  resolves → issue* — the chain of evidence, not just a ranked list.
+- **An inspector on every node**: underlying content, score, source link.
+- **The execution timeline** of the run: each agent step, each retriever
+  call, per-span timings, and which retrieval arm (vector / graph) produced
+  the results.
+
+## Requirements
+
+| | |
+|---|---|
+| Python | ≥ 3.10 |
+| Runtime dependencies | **none** (stdlib only) |
+| Platforms | Windows, macOS, Linux |
+| Browser | any modern browser |
+
+## Usage
+
+```
+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. |
+| `--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`.
+
+## Producing traces
+
+Graphsight renders any file matching its trace JSON contract. Current
+producers:
+
+- **[graphsight-langgraph](https://pypi.org/project/graphsight-langgraph/)** —
+  instrument any [LangGraph](https://github.com/langchain-ai/langgraph)
+  agent with a single callback handler, or trace a GitHub repository in one
+  command:
+
+  ```bash
+  pip install "graphsight-langgraph[example]"
+  graphsight-github-trace langchain-ai/langgraph "who fixed the recent streaming bugs?"
+  graphsight graphsight_out/trace_state.json
+  ```
+
+- **The TraceRAG engine** — the graph-memory backend this project grew out
+  of; its `/api/trace` responses are the same shape.
+
+Adapters for LlamaIndex and raw OpenTelemetry spans are planned; all
+producers emit the same schema and render in this same viewer.
+
+### Writing your own producer
+
+The minimum contract is small — a JSON object with:
+
+```jsonc
+{
+  "query": "the question that was asked",          // required, string
+  "graph": {
+    "nodes": [{ "id", "label", "type", "score", "meta": { "snippet", "sourceUrl" } }],
+    "edges": [{ "id", "source", "target", "relation", "confidence" }]
+  },
+  "steps":   [ /* execution timeline, optional */ ],
+  "metrics": { "queryTimeSec": 0.004 }             // optional
+}
+```
+
+Node positions are computed client-side; emitters never deal with layout.
+The complete schema and a reference emitter live in the
+[graphsight-langgraph source](https://github.com/Kcodess2807/graphsight/tree/main/graphsight-langgraph).
+
+## Security and privacy
+
+- The dependency list is empty by design: the UI is a bundled static build
+  (Vite + React + React Flow) served by Python's stdlib `http.server`.
+- Binds to `127.0.0.1` — not reachable from other machines.
+- No accounts, no telemetry, no outbound network calls. Your traces stay on
+  your disk.
+
+## Troubleshooting
+
+| Symptom | Cause / fix |
+|---|---|
+| `Address already in use` | Another process holds the port — pass `--port 4631`. |
+| Browser doesn't open | Some environments (SSH, WSL, containers) can't launch one — start with `--no-browser` and open the printed URL yourself. |
+| `Bundled UI missing` error | Broken installation — `pip install --force-reinstall graphsight`. |
+| Page loads but trace doesn't | The JSON didn't match the contract — the import page shows the specific validation error. |
+
+## Links
+
+- Source & issue tracker: [github.com/Kcodess2807/graphsight](https://github.com/Kcodess2807/graphsight)
+- LangGraph adapter: [graphsight-langgraph on PyPI](https://pypi.org/project/graphsight-langgraph/)
+- Beta test script: [BETA.md](https://github.com/Kcodess2807/graphsight/blob/main/BETA.md)
+
+## License
+
+MIT © Arush Karnatak

graphsight-0.1.2/README.md

@@ -0,0 +1,121 @@
+# graphsight
+
+[![PyPI](https://img.shields.io/pypi/v/graphsight.svg)](https://pypi.org/project/graphsight/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://pypi.org/project/graphsight/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://github.com/Kcodess2807/graphsight/blob/main/graphsight/LICENSE)
+
+**See exactly why your AI agent retrieved what it did.**
+
+Your agent answered a question. Which documents did it actually pull? What
+scores did they get? How are they connected to each other? Most stacks make
+you dig through logs to answer that. Graphsight renders the run as an
+**interactive graph in your browser** — one command, zero dependencies,
+nothing leaves your machine.
+
+```bash
+pip install graphsight
+graphsight path/to/trace_state.json
+```
+
+## What you get
+
+- **Every retrieved item as a typed node** — PR, Service, Person, Ticket,
+  Document, Repo, Library, Team, Tool — with its retrieval score.
+- **Relational paths between results** — *person → authored → PR →
+  resolves → issue* — the chain of evidence, not just a ranked list.
+- **An inspector on every node**: underlying content, score, source link.
+- **The execution timeline** of the run: each agent step, each retriever
+  call, per-span timings, and which retrieval arm (vector / graph) produced
+  the results.
+
+## Requirements
+
+| | |
+|---|---|
+| Python | ≥ 3.10 |
+| Runtime dependencies | **none** (stdlib only) |
+| Platforms | Windows, macOS, Linux |
+| Browser | any modern browser |
+
+## Usage
+
+```
+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. |
+| `--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`.
+
+## Producing traces
+
+Graphsight renders any file matching its trace JSON contract. Current
+producers:
+
+- **[graphsight-langgraph](https://pypi.org/project/graphsight-langgraph/)** —
+  instrument any [LangGraph](https://github.com/langchain-ai/langgraph)
+  agent with a single callback handler, or trace a GitHub repository in one
+  command:
+
+  ```bash
+  pip install "graphsight-langgraph[example]"
+  graphsight-github-trace langchain-ai/langgraph "who fixed the recent streaming bugs?"
+  graphsight graphsight_out/trace_state.json
+  ```
+
+- **The TraceRAG engine** — the graph-memory backend this project grew out
+  of; its `/api/trace` responses are the same shape.
+
+Adapters for LlamaIndex and raw OpenTelemetry spans are planned; all
+producers emit the same schema and render in this same viewer.
+
+### Writing your own producer
+
+The minimum contract is small — a JSON object with:
+
+```jsonc
+{
+  "query": "the question that was asked",          // required, string
+  "graph": {
+    "nodes": [{ "id", "label", "type", "score", "meta": { "snippet", "sourceUrl" } }],
+    "edges": [{ "id", "source", "target", "relation", "confidence" }]
+  },
+  "steps":   [ /* execution timeline, optional */ ],
+  "metrics": { "queryTimeSec": 0.004 }             // optional
+}
+```
+
+Node positions are computed client-side; emitters never deal with layout.
+The complete schema and a reference emitter live in the
+[graphsight-langgraph source](https://github.com/Kcodess2807/graphsight/tree/main/graphsight-langgraph).
+
+## Security and privacy
+
+- The dependency list is empty by design: the UI is a bundled static build
+  (Vite + React + React Flow) served by Python's stdlib `http.server`.
+- Binds to `127.0.0.1` — not reachable from other machines.
+- No accounts, no telemetry, no outbound network calls. Your traces stay on
+  your disk.
+
+## Troubleshooting
+
+| Symptom | Cause / fix |
+|---|---|
+| `Address already in use` | Another process holds the port — pass `--port 4631`. |
+| Browser doesn't open | Some environments (SSH, WSL, containers) can't launch one — start with `--no-browser` and open the printed URL yourself. |
+| `Bundled UI missing` error | Broken installation — `pip install --force-reinstall graphsight`. |
+| Page loads but trace doesn't | The JSON didn't match the contract — the import page shows the specific validation error. |
+
+## Links
+
+- Source & issue tracker: [github.com/Kcodess2807/graphsight](https://github.com/Kcodess2807/graphsight)
+- LangGraph adapter: [graphsight-langgraph on PyPI](https://pypi.org/project/graphsight-langgraph/)
+- Beta test script: [BETA.md](https://github.com/Kcodess2807/graphsight/blob/main/BETA.md)
+
+## License
+
+MIT © Arush Karnatak

{graphsight-0.1.0 → graphsight-0.1.2}/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.0"
+__version__ = "0.1.2"

graphsight-0.1.2/graphsight.egg-info/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: graphsight
+Version: 0.1.2
+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
+Project-URL: Repository, https://github.com/Kcodess2807/graphsight
+Project-URL: Documentation, https://github.com/Kcodess2807/graphsight/tree/main/graphsight
+Keywords: tracing,observability,rag,retrieval,agents,visualization,langgraph
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# graphsight
+
+[![PyPI](https://img.shields.io/pypi/v/graphsight.svg)](https://pypi.org/project/graphsight/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://pypi.org/project/graphsight/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://github.com/Kcodess2807/graphsight/blob/main/graphsight/LICENSE)
+
+**See exactly why your AI agent retrieved what it did.**
+
+Your agent answered a question. Which documents did it actually pull? What
+scores did they get? How are they connected to each other? Most stacks make
+you dig through logs to answer that. Graphsight renders the run as an
+**interactive graph in your browser** — one command, zero dependencies,
+nothing leaves your machine.
+
+```bash
+pip install graphsight
+graphsight path/to/trace_state.json
+```
+
+## What you get
+
+- **Every retrieved item as a typed node** — PR, Service, Person, Ticket,
+  Document, Repo, Library, Team, Tool — with its retrieval score.
+- **Relational paths between results** — *person → authored → PR →
+  resolves → issue* — the chain of evidence, not just a ranked list.
+- **An inspector on every node**: underlying content, score, source link.
+- **The execution timeline** of the run: each agent step, each retriever
+  call, per-span timings, and which retrieval arm (vector / graph) produced
+  the results.
+
+## Requirements
+
+| | |
+|---|---|
+| Python | ≥ 3.10 |
+| Runtime dependencies | **none** (stdlib only) |
+| Platforms | Windows, macOS, Linux |
+| Browser | any modern browser |
+
+## Usage
+
+```
+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. |
+| `--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`.
+
+## Producing traces
+
+Graphsight renders any file matching its trace JSON contract. Current
+producers:
+
+- **[graphsight-langgraph](https://pypi.org/project/graphsight-langgraph/)** —
+  instrument any [LangGraph](https://github.com/langchain-ai/langgraph)
+  agent with a single callback handler, or trace a GitHub repository in one
+  command:
+
+  ```bash
+  pip install "graphsight-langgraph[example]"
+  graphsight-github-trace langchain-ai/langgraph "who fixed the recent streaming bugs?"
+  graphsight graphsight_out/trace_state.json
+  ```
+
+- **The TraceRAG engine** — the graph-memory backend this project grew out
+  of; its `/api/trace` responses are the same shape.
+
+Adapters for LlamaIndex and raw OpenTelemetry spans are planned; all
+producers emit the same schema and render in this same viewer.
+
+### Writing your own producer
+
+The minimum contract is small — a JSON object with:
+
+```jsonc
+{
+  "query": "the question that was asked",          // required, string
+  "graph": {
+    "nodes": [{ "id", "label", "type", "score", "meta": { "snippet", "sourceUrl" } }],
+    "edges": [{ "id", "source", "target", "relation", "confidence" }]
+  },
+  "steps":   [ /* execution timeline, optional */ ],
+  "metrics": { "queryTimeSec": 0.004 }             // optional
+}
+```
+
+Node positions are computed client-side; emitters never deal with layout.
+The complete schema and a reference emitter live in the
+[graphsight-langgraph source](https://github.com/Kcodess2807/graphsight/tree/main/graphsight-langgraph).
+
+## Security and privacy
+
+- The dependency list is empty by design: the UI is a bundled static build
+  (Vite + React + React Flow) served by Python's stdlib `http.server`.
+- Binds to `127.0.0.1` — not reachable from other machines.
+- No accounts, no telemetry, no outbound network calls. Your traces stay on
+  your disk.
+
+## Troubleshooting
+
+| Symptom | Cause / fix |
+|---|---|
+| `Address already in use` | Another process holds the port — pass `--port 4631`. |
+| Browser doesn't open | Some environments (SSH, WSL, containers) can't launch one — start with `--no-browser` and open the printed URL yourself. |
+| `Bundled UI missing` error | Broken installation — `pip install --force-reinstall graphsight`. |
+| Page loads but trace doesn't | The JSON didn't match the contract — the import page shows the specific validation error. |
+
+## Links
+
+- Source & issue tracker: [github.com/Kcodess2807/graphsight](https://github.com/Kcodess2807/graphsight)
+- LangGraph adapter: [graphsight-langgraph on PyPI](https://pypi.org/project/graphsight-langgraph/)
+- Beta test script: [BETA.md](https://github.com/Kcodess2807/graphsight/blob/main/BETA.md)
+
+## License
+
+MIT © Arush Karnatak

{graphsight-0.1.0 → graphsight-0.1.2}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "graphsight"
-version = "0.1.0"
-description = "Local viewer for agent retrieval traces — open a trace_state.json in the Graphsight Studio with one command, no backend."
+version = "0.1.2"
+description = "See why your AI agent retrieved what it did — interactive graph viewer for agent retrieval traces. One command, zero dependencies, nothing leaves your machine."
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "MIT" }

graphsight-0.1.0/PKG-INFO

@@ -1,79 +0,0 @@
-Metadata-Version: 2.4
-Name: graphsight
-Version: 0.1.0
-Summary: Local viewer for agent retrieval traces — open a trace_state.json in the Graphsight Studio with one command, no backend.
-Author: Arush Karnatak
-License: MIT
-Project-URL: Repository, https://github.com/Kcodess2807/graphsight
-Project-URL: Documentation, https://github.com/Kcodess2807/graphsight/tree/main/graphsight
-Keywords: tracing,observability,rag,retrieval,agents,visualization,langgraph
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Debuggers
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# graphsight
-
-**Open an agent retrieval trace in your browser with one command.**
-
-```bash
-pip install graphsight
-graphsight path/to/trace_state.json
-```
-
-That's it — a local server starts (stdlib only, zero dependencies), your
-browser opens, and the Graphsight Studio renders the trace: the retrieved
-entities as a graph, relational edges between them, per-item scores, and the
-execution timeline of the run that produced it. No backend, no account, no
-telemetry — nothing leaves localhost.
-
-## Where traces come from
-
-Any tool that emits the Studio's `TraceState` JSON. Today that's:
-
-- [`graphsight-langgraph`](../graphsight-langgraph) — trace any LangGraph agent
-  with one callback handler:
-
-  ```bash
-  pip install "graphsight-langgraph[example]"
-  graphsight-github-trace langchain-ai/langgraph "who fixed the recent streaming bugs?"
-  graphsight graphsight_out/trace_state.json
-  ```
-
-- The full TraceRAG engine (this repo) — its `/api/trace` responses are the
-  same shape.
-
-LlamaIndex and raw-OTel adapters are planned; they'll emit the same schema.
-
-## CLI
-
-```
-graphsight [trace_state.json] [--port 4630] [--no-browser]
-```
-
-- With a trace file: serves it and opens `/memory/import?src=…` — the Studio
-  auto-loads it.
-- Without: opens the import page, where you can drag-and-drop or paste JSON.
-
-## How it's built
-
-The package bundles a static build of the Studio UI (Vite + React + React
-Flow) and serves it with Python's stdlib `http.server` — which is why the
-dependency list is empty. The UI source lives in
-[`frontend/`](../frontend) in the main repo; to refresh the bundle:
-
-```bash
-cd frontend && npm run build
-rm -rf ../graphsight/graphsight/dist
-cp -r dist ../graphsight/graphsight/dist
-```

graphsight-0.1.0/README.md

@@ -1,55 +0,0 @@
-# graphsight
-
-**Open an agent retrieval trace in your browser with one command.**
-
-```bash
-pip install graphsight
-graphsight path/to/trace_state.json
-```
-
-That's it — a local server starts (stdlib only, zero dependencies), your
-browser opens, and the Graphsight Studio renders the trace: the retrieved
-entities as a graph, relational edges between them, per-item scores, and the
-execution timeline of the run that produced it. No backend, no account, no
-telemetry — nothing leaves localhost.
-
-## Where traces come from
-
-Any tool that emits the Studio's `TraceState` JSON. Today that's:
-
-- [`graphsight-langgraph`](../graphsight-langgraph) — trace any LangGraph agent
-  with one callback handler:
-
-  ```bash
-  pip install "graphsight-langgraph[example]"
-  graphsight-github-trace langchain-ai/langgraph "who fixed the recent streaming bugs?"
-  graphsight graphsight_out/trace_state.json
-  ```
-
-- The full TraceRAG engine (this repo) — its `/api/trace` responses are the
-  same shape.
-
-LlamaIndex and raw-OTel adapters are planned; they'll emit the same schema.
-
-## CLI
-
-```
-graphsight [trace_state.json] [--port 4630] [--no-browser]
-```
-
-- With a trace file: serves it and opens `/memory/import?src=…` — the Studio
-  auto-loads it.
-- Without: opens the import page, where you can drag-and-drop or paste JSON.
-
-## How it's built
-
-The package bundles a static build of the Studio UI (Vite + React + React
-Flow) and serves it with Python's stdlib `http.server` — which is why the
-dependency list is empty. The UI source lives in
-[`frontend/`](../frontend) in the main repo; to refresh the bundle:
-
-```bash
-cd frontend && npm run build
-rm -rf ../graphsight/graphsight/dist
-cp -r dist ../graphsight/graphsight/dist
-```

graphsight-0.1.0/graphsight.egg-info/PKG-INFO

@@ -1,79 +0,0 @@
-Metadata-Version: 2.4
-Name: graphsight
-Version: 0.1.0
-Summary: Local viewer for agent retrieval traces — open a trace_state.json in the Graphsight Studio with one command, no backend.
-Author: Arush Karnatak
-License: MIT
-Project-URL: Repository, https://github.com/Kcodess2807/graphsight
-Project-URL: Documentation, https://github.com/Kcodess2807/graphsight/tree/main/graphsight
-Keywords: tracing,observability,rag,retrieval,agents,visualization,langgraph
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Debuggers
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# graphsight
-
-**Open an agent retrieval trace in your browser with one command.**
-
-```bash
-pip install graphsight
-graphsight path/to/trace_state.json
-```
-
-That's it — a local server starts (stdlib only, zero dependencies), your
-browser opens, and the Graphsight Studio renders the trace: the retrieved
-entities as a graph, relational edges between them, per-item scores, and the
-execution timeline of the run that produced it. No backend, no account, no
-telemetry — nothing leaves localhost.
-
-## Where traces come from
-
-Any tool that emits the Studio's `TraceState` JSON. Today that's:
-
-- [`graphsight-langgraph`](../graphsight-langgraph) — trace any LangGraph agent
-  with one callback handler:
-
-  ```bash
-  pip install "graphsight-langgraph[example]"
-  graphsight-github-trace langchain-ai/langgraph "who fixed the recent streaming bugs?"
-  graphsight graphsight_out/trace_state.json
-  ```
-
-- The full TraceRAG engine (this repo) — its `/api/trace` responses are the
-  same shape.
-
-LlamaIndex and raw-OTel adapters are planned; they'll emit the same schema.
-
-## CLI
-
-```
-graphsight [trace_state.json] [--port 4630] [--no-browser]
-```
-
-- With a trace file: serves it and opens `/memory/import?src=…` — the Studio
-  auto-loads it.
-- Without: opens the import page, where you can drag-and-drop or paste JSON.
-
-## How it's built
-
-The package bundles a static build of the Studio UI (Vite + React + React
-Flow) and serves it with Python's stdlib `http.server` — which is why the
-dependency list is empty. The UI source lives in
-[`frontend/`](../frontend) in the main repo; to refresh the bundle:
-
-```bash
-cd frontend && npm run build
-rm -rf ../graphsight/graphsight/dist
-cp -r dist ../graphsight/graphsight/dist
-```