sovara 0.2.0__tar.gz → 0.2.3__tar.gz

{sovara-0.2.0 → sovara-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sovara
-Version: 0.2.0
+Version: 0.2.3
 Summary: A development tool for LLM call visualization and debugging
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -14,6 +14,7 @@ Requires-Dist: python-dotenv
 Requires-Dist: fastapi
 Requires-Dist: uvicorn[standard]
 Requires-Dist: httpx
+Requires-Dist: litellm
 Requires-Dist: flatten_dict
 Requires-Dist: flatten_json
 Provides-Extra: dev
@@ -32,6 +33,8 @@ Requires-Dist: langchain; extra == "dev"
 Requires-Dist: langchain-anthropic; extra == "dev"
 Requires-Dist: langchain-openai; extra == "dev"
 Requires-Dist: websocket-client; extra == "dev"
+Provides-Extra: desktop
+Requires-Dist: pyinstaller>=6.11; extra == "desktop"
 Provides-Extra: examples
 Requires-Dist: openai; extra == "examples"
 Requires-Dist: anthropic; extra == "examples"

{sovara-0.2.0 → sovara-0.2.3}/README.md

@@ -76,25 +76,67 @@ This should show you the agent's trajectory graph like in the video above. You c
 ## Integration with Coding Agents
 Coding Agents already accelerate generic coding quite successfully. By augmenting them with `sovara`, you can supercharge your agent development while making sure you adhere to state-of-the-art coding practices for enterprise-grade agents.
 
+### Why use these integrations?
+
+- **Keep context clean**: Agent runs produce verbose logs that quickly pollute a coding agent's context window. With `so-cli`, it queries only the specific nodes it needs.
+- **Structured access**: Your agent gets structured JSON data (inputs, outputs, graph topology) rather than parsing raw logs.
+- **Edit and rerun**: Your agent can programmatically edit an LLM's input or output and trigger a rerun to test hypotheses.
+
+<h3><img src="docs/media/codex.png" alt="Codex" height="24" align="absmiddle">&nbsp;&nbsp;Codex</h3>
+
+Install globally:
+
+```bash
+so-cli install-skill --target codex
+```
+
+This copies the shared Sovara skill to `$HOME/.agents/skills/sovara/`, so you can use it from any repository. The installer only copies skill files and does not modify Codex settings.
+
+To install it for a specific project instead:
+
+```bash
+so-cli install-skill --target codex --level project
+```
+
+That copies the skill to `.agents/skills/sovara/` under the selected project. Codex also scans `.agents/skills` from your current working directory up to the repository root, so project-level skills can be scoped to a repo or subdirectory.
+
+Use Sovara in Codex by asking for `$sovara` explicitly, or let Codex invoke it automatically when the task matches the skill description.
+
+Example prompts:
+
+```text
+$sovara inspect the latest run and find the first failing node
+$sovara compare these two runs and explain why the outputs diverged
+$sovara propose a prior based on the failure pattern in this run
+```
+
+Codex detects skill changes automatically. If an update does not appear, restart Codex.
+
 <h3><img src="docs/media/cc.png" alt="Claude Code" height="24" align="absmiddle">&nbsp;&nbsp;Claude Code</h3>
 
-**Setup:**
+Install globally:
+
+```bash
+so-cli install-skill --target claude
+```
+
+This copies the shared Sovara skill to `~/.claude/skills/sovara/`, so it is available across all your projects. The installer only copies skill files and does not modify Claude settings.
+
+To install it for one project instead:
 
 ```bash
-so-tool install-skill
+so-cli install-skill --target claude --level project
 ```
 
-This interactive command will:
-1. Copy the Sovara skill file to your project's `.claude/skills/sovara/` directory
-2. Add Bash permissions so Claude Code can run `so-tool` commands without prompts
+That copies the skill to `.claude/skills/sovara/` under the selected project. Re-open Claude Code after installation if the skill does not appear immediately.
 
-After setup, restart Claude Code and ask "What skills are available?". The sovara skill should now show up, and you can start developing/improving your agent as you would normally do.
+Use Sovara in Claude Code by letting Claude invoke the skill automatically when relevant, or select it directly from the skill menu if needed.
 
-**Why use this integration?**
+If you want both integrations installed globally in one step, run:
 
-- **Keep context clean**: Agent runs produce verbose logs that quickly pollute Claude's context window. With `so-tool`, Claude queries only the specific nodes it needs.
-- **Structured access**: Claude gets structured JSON data (inputs, outputs, graph topology) rather than parsing raw logs.
-- **Edit and rerun**: Claude can programmatically edit an LLM's input or output and trigger a rerun to test hypotheses.
+```bash
+so-cli install-skill
+```
 
 ## Documentation
 

{sovara-0.2.0 → sovara-0.2.3}/pyproject.toml

@@ -5,7 +5,7 @@ requires = ["setuptools"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools.package-data]
-"sovara.assets" = ["SKILL.md"]
+"sovara.assets" = ["SKILL.md", "web_app/**/*"]
 
 [tool.setuptools]
 package-dir = {"" = "src"}
@@ -19,14 +19,14 @@ include = ["sovara*"]
 so-record = "sovara.cli.so_record:main"
 so-config = "sovara.cli.so_config:main"
 so-server = "sovara.cli.so_server:main"
-so-tool = "sovara.cli.so_tool:main"
+so-cli = "sovara.cli.so_tool:main"
 
 [tool.black]
 line-length = 100
 
 [project]
 name = "sovara"
-version = "0.2.0"
+version = "0.2.3"
 description = "A development tool for LLM call visualization and debugging"
 readme = "docs/release/PYPI_DESC.md"
 requires-python = ">=3.10"
@@ -41,6 +41,7 @@ dependencies = [
     "fastapi",
     "uvicorn[standard]",
     "httpx",
+    "litellm",
     "flatten_dict",
     "flatten_json"
 ]
@@ -64,6 +65,10 @@ dev = [
     "websocket-client"
 ]
 
+desktop = [
+    "pyinstaller>=6.11",
+]
+
 examples = [
     "openai",
     "anthropic",
@@ -76,3 +81,8 @@ docs = [
     "mkdocs-minify-plugin",
     "mkdocstrings[python]>=0.24",
 ]
+
+[tool.pytest.ini_options]
+filterwarnings = [
+    "ignore:'_UnionGenericAlias' is deprecated and slated for removal in Python 3\\.17:DeprecationWarning:google\\.genai\\.types",
+]