sovara 0.2.1__tar.gz → 0.2.4__tar.gz

{sovara-0.2.1 → sovara-0.2.4}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: sovara
-Version: 0.2.1
+Version: 0.2.4
 Summary: A development tool for LLM call visualization and debugging
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyyaml
 Requires-Dist: dill
+Requires-Dist: boto3
 Requires-Dist: debugpy
 Requires-Dist: psutil
 Requires-Dist: psycopg2-binary
@@ -15,6 +16,8 @@ Requires-Dist: fastapi
 Requires-Dist: uvicorn[standard]
 Requires-Dist: httpx
 Requires-Dist: litellm
+Requires-Dist: google-auth
+Requires-Dist: google-cloud-aiplatform
 Requires-Dist: flatten_dict
 Requires-Dist: flatten_json
 Provides-Extra: dev
@@ -33,6 +36,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.1 → sovara-0.2.4}/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"}
@@ -26,7 +26,7 @@ line-length = 100
 
 [project]
 name = "sovara"
-version = "0.2.1"
+version = "0.2.4"
 description = "A development tool for LLM call visualization and debugging"
 readme = "docs/release/PYPI_DESC.md"
 requires-python = ">=3.10"
@@ -34,6 +34,7 @@ requires-python = ">=3.10"
 dependencies = [
     "pyyaml",
     "dill",
+    "boto3",
     "debugpy",
     "psutil",
     "psycopg2-binary",
@@ -42,6 +43,8 @@ dependencies = [
     "uvicorn[standard]",
     "httpx",
     "litellm",
+    "google-auth",
+    "google-cloud-aiplatform",
     "flatten_dict",
     "flatten_json"
 ]
@@ -65,6 +68,10 @@ dev = [
     "websocket-client"
 ]
 
+desktop = [
+    "pyinstaller>=6.11",
+]
+
 examples = [
     "openai",
     "anthropic",

{sovara-0.2.1 → sovara-0.2.4}/src/sovara/assets/SKILL.md

@@ -16,6 +16,9 @@ description: sovara helps you develop and maintain adaptable agentic systems. It
 ## Setup
 
 1. **Check for caching conflicts**: Scan the user-code for caching mechanisms (such as ad-hoc implementation of LLM-input caching or benchmark caching) that can interfere with the re-run capability. If you encounter such caching, flag this to the user and propose to change it by, for example, being able to disable caching with a `--no-cache` flag. **NOTE:** Caching that happens at the API provider level, for example using `cache_control` in the Anthropic API is OK!
+2. **Check setup state before the first run**: Start with `uv run so-cli status --path <script-or-project-dir>`. This reports whether the local Sovara user is configured and whether the target directory already belongs to a Sovara project.
+3. **Initialize explicitly when setup is missing**: If the user or project is missing, run `uv run so-cli init --user-name "<full name>" --user-email "<email>" [--project-root <dir> --project-name "<name>"]`. Do not reason about `~/.sovara/.user_id` or `.sovara/.project_id` directly if the CLI can tell you the setup state.
+4. **For non-interactive runs, pass setup through the CLI**: When running through Codex or another non-interactive shell, do not rely on prompts. Use `so-cli init` first or pass `--user-name`, `--user-email`, `--project-root`, `--project-name`, and `--project-description` directly to `so-cli record`.
 
 ## Integrated Observability
 
@@ -27,7 +30,11 @@ Run any agent and record the dataflow graph, as well as input/output to each nod
 The tool is generally structured like this.
 
 ```
-usage: so-cli record [-h] [-m] [--run-name RUN_NAME] [--timeout TIMEOUT] script_path ...
+usage: so-cli record [-h] [-m] [-u] [--run-name RUN_NAME] [--user-name USER_NAME]
+                     [--user-email USER_EMAIL] [--project-root PROJECT_ROOT]
+                     [--project-name PROJECT_NAME]
+                     [--project-description PROJECT_DESCRIPTION]
+                     [--timeout TIMEOUT] script_path ...
 
 positional arguments:
   script_path          Script to execute (or module name with -m)
@@ -36,7 +43,18 @@ positional arguments:
 options:
   -h, --help           show this help message and exit
   -m, --module         Run script_path as a Python module (like python -m)
+  -u, --unbuffered     Run with unbuffered stdout/stderr, like python -u
   --run-name RUN_NAME  Human-readable name for this run
+  --user-name USER_NAME
+                       Override or create the local Sovara user full name
+  --user-email USER_EMAIL
+                       Override or create the local Sovara user email
+  --project-root PROJECT_ROOT
+                       Project root to resolve or create for this run
+  --project-name PROJECT_NAME
+                       Override or create the Sovara project name
+  --project-description PROJECT_DESCRIPTION
+                       Override or create the Sovara project description
   --timeout TIMEOUT    Timeout in seconds (terminates script if exceeded)
 ```
 
@@ -46,6 +64,16 @@ Example:
 uv run so-cli record --run-name "OAI-debate-run-1" --timeout 60 example_workflows/debug_examples/openai/debate.py
 ```
 
+First-run example with explicit setup:
+
+```bash
+uv run so-cli init \
+  --user-name "Jane Doe" \
+  --user-email "jane@example.com" \
+  --project-root example_workflows/debug_examples/openai \
+  --project-name openai-debug
+```
+
 This will return
 ```json
 {
@@ -208,6 +236,40 @@ This will produce the full result (no preview) of the specific keys that match t
 }
 ```
 
+### Inspect persisted logs
+If you want to inspect the captured stdout/stderr transcript for a run, use the `logs` command. Unlike `probe` and `runs`, this command prints plain text rather than JSON.
+
+The tool is generally structured like this.
+
+```
+usage: so-cli logs [-h] [--tail TAIL] [--grep GREP] [--context CONTEXT] [--line-numbers] run_id
+
+positional arguments:
+  run_id                Run ID to fetch logs for
+
+options:
+  -h, --help            show this help message and exit
+  --tail TAIL           Show only the last N displayed lines
+  --grep GREP           Filter displayed lines using a regex pattern
+  --context CONTEXT     Show N lines of context around each grep match
+  --line-numbers        Prefix displayed lines with original line numbers
+```
+
+`run_id` accepts a full UUID or any unambiguous prefix, just like `probe`.
+
+Examples:
+To inspect the last 40 lines of a run, run
+
+```bash
+uv run so-cli logs b6aaf796 --tail 40
+```
+
+To search a large log for cache misses with nearby context and original line numbers, run
+
+```bash
+uv run so-cli logs b6aaf796 --grep "Cache miss" --context 2 --line-numbers
+```
+
 ### List and manage runs
 You can manage past runs that you did with the `runs` command, which is structured in the following way
 
@@ -577,23 +639,25 @@ Representative outputs:
 
 **Problem:** You are running inside a sandboxed environment and Sovara commands fail because they try to write under `~/.sovara`, `~/.cache`, or Python cache locations.
 
-**Solution:** Redirect all writable runtime state into `/tmp` before invoking the CLI:
+**Solution:** Redirect writable cache and Python temp state into `/tmp` before invoking the CLI:
 
 ```bash
-export SOVARA_HOME=/tmp/sovara-home
 export SOVARA_CACHE=/tmp/sovara-cache
-export SOVARA_GIT_DIR=/tmp/sovara-git
 export UV_CACHE_DIR=/tmp/uv-cache
 export PYTHONPYCACHEPREFIX=/tmp/pycache
 ```
 
-This is the most important variable:
+Sovara still keeps durable state under `~/.sovara`, so cache-only redirection only helps with non-persistent writes.
 
-- `SOVARA_HOME=/tmp/sovara-home`
+**Important limitation:** this only fixes cache/temp writes. If `so-cli record` needs to start the local Sovara server, that startup still writes durable state under `~/.sovara` (logs, config, DB, lock files). In Codex or another sandboxed agent, the smooth workflow is to start the server outside the sandbox first:
 
-because it moves the default config, DB, and logs out of `~/.sovara`. The other variables avoid cache writes outside the sandbox's writable area.
+```bash
+so-server start
+```
+
+Then run `so-cli record`, `so-cli runs`, `so-cli probe`, `so-cli logs`, and `so-cli edit-and-rerun` from inside Codex against the already-running server.
 
-**Important limitation:** this only fixes filesystem permission issues. If the sandbox also forbids binding a localhost port, server-backed commands like `runs`, `probe`, and `edit-and-rerun` may still fail until Sovara supports a no-daemon / in-process CLI transport.
+If the sandbox also forbids binding a localhost port, server-backed commands may still fail until Sovara supports a no-daemon / in-process CLI transport.
 
 ### Priors server not reachable
 
@@ -612,6 +676,20 @@ because it moves the default config, DB, and logs out of `~/.sovara`. The other
 
 After making this change, restart your agent shell/session for the new environment to take effect.
 
+### Missing user or project setup
+
+**Problem:** `so-cli record` reports that Sovara user or project setup is missing and the session cannot prompt.
+
+**Solution:** Run `so-cli status --path <target>` to inspect the missing pieces, then initialize them explicitly:
+
+```bash
+uv run so-cli init \
+  --user-name "<full name>" \
+  --user-email "<email>" \
+  --project-root <target-dir> \
+  --project-name "<project name>"
+```
+
 ---
 
 - You executed a code using  `uv run so-cli --help`

sovara-0.2.4/src/sovara/assets/web_app/assets/AttachmentPreview-CFrNMdfC.css

@@ -0,0 +1 @@
+:root{--react-pdf-annotation-layer: 1;--annotation-unfocused-field-background: url("data:image/svg+xml;charset=UTF-8,<svg width='1px' height='1px' xmlns='http://www.w3.org/2000/svg'><rect width='100%' height='100%' style='fill:rgba(0, 54, 255, 0.13);'/></svg>");--input-focus-border-color: Highlight;--input-focus-outline: 1px solid Canvas;--input-unfocused-border-color: transparent;--input-disabled-border-color: transparent;--input-hover-border-color: black;--link-outline: none}@media screen and (forced-colors:active){:root{--input-focus-border-color: CanvasText;--input-unfocused-border-color: ActiveText;--input-disabled-border-color: GrayText;--input-hover-border-color: Highlight;--link-outline: 1.5px solid LinkText}.annotationLayer .textWidgetAnnotation :is(input,textarea):required,.annotationLayer .choiceWidgetAnnotation select:required,.annotationLayer .buttonWidgetAnnotation:is(.checkBox,.radioButton) input:required{outline:1.5px solid selectedItem}.annotationLayer .linkAnnotation:hover{-webkit-backdrop-filter:invert(100%);backdrop-filter:invert(100%)}}.annotationLayer{position:absolute;top:0;left:0;pointer-events:none;transform-origin:0 0;z-index:3}.annotationLayer[data-main-rotation="90"] .norotate{transform:rotate(270deg) translate(-100%)}.annotationLayer[data-main-rotation="180"] .norotate{transform:rotate(180deg) translate(-100%,-100%)}.annotationLayer[data-main-rotation="270"] .norotate{transform:rotate(90deg) translateY(-100%)}.annotationLayer canvas{position:absolute;width:100%;height:100%}.annotationLayer section{position:absolute;text-align:initial;pointer-events:auto;box-sizing:border-box;margin:0;transform-origin:0 0}.annotationLayer .linkAnnotation{outline:var(--link-outline)}.textLayer.selecting~.annotationLayer section{pointer-events:none}.annotationLayer :is(.linkAnnotation,.buttonWidgetAnnotation.pushButton)>a{position:absolute;font-size:1em;top:0;left:0;width:100%;height:100%}.annotationLayer :is(.linkAnnotation,.buttonWidgetAnnotation.pushButton)>a:hover{opacity:.2;background:#ff0;box-shadow:0 2px 10px #ff0}.annotationLayer .textAnnotation img{position:absolute;cursor:pointer;width:100%;height:100%;top:0;left:0}.annotationLayer .textWidgetAnnotation :is(input,textarea),.annotationLayer .choiceWidgetAnnotation select,.annotationLayer .buttonWidgetAnnotation:is(.checkBox,.radioButton) input{background-image:var(--annotation-unfocused-field-background);border:2px solid var(--input-unfocused-border-color);box-sizing:border-box;font:calc(9px * var(--total-scale-factor)) sans-serif;height:100%;margin:0;vertical-align:top;width:100%}.annotationLayer .textWidgetAnnotation :is(input,textarea):required,.annotationLayer .choiceWidgetAnnotation select:required,.annotationLayer .buttonWidgetAnnotation:is(.checkBox,.radioButton) input:required{outline:1.5px solid red}.annotationLayer .choiceWidgetAnnotation select option{padding:0}.annotationLayer .buttonWidgetAnnotation.radioButton input{border-radius:50%}.annotationLayer .textWidgetAnnotation textarea{resize:none}.annotationLayer .textWidgetAnnotation :is(input,textarea)[disabled],.annotationLayer .choiceWidgetAnnotation select[disabled],.annotationLayer .buttonWidgetAnnotation:is(.checkBox,.radioButton) input[disabled]{background:none;border:2px solid var(--input-disabled-border-color);cursor:not-allowed}.annotationLayer .textWidgetAnnotation :is(input,textarea):hover,.annotationLayer .choiceWidgetAnnotation select:hover,.annotationLayer .buttonWidgetAnnotation:is(.checkBox,.radioButton) input:hover{border:2px solid var(--input-hover-border-color)}.annotationLayer .textWidgetAnnotation :is(input,textarea):hover,.annotationLayer .choiceWidgetAnnotation select:hover,.annotationLayer .buttonWidgetAnnotation.checkBox input:hover{border-radius:2px}.annotationLayer .textWidgetAnnotation :is(input,textarea):focus,.annotationLayer .choiceWidgetAnnotation select:focus{background:none;border:2px solid var(--input-focus-border-color);border-radius:2px;outline:var(--input-focus-outline)}.annotationLayer .buttonWidgetAnnotation:is(.checkBox,.radioButton) :focus{background-image:none;background-color:transparent}.annotationLayer .buttonWidgetAnnotation.checkBox :focus{border:2px solid var(--input-focus-border-color);border-radius:2px;outline:var(--input-focus-outline)}.annotationLayer .buttonWidgetAnnotation.radioButton :focus{border:2px solid var(--input-focus-border-color);outline:var(--input-focus-outline)}.annotationLayer .buttonWidgetAnnotation.checkBox input:checked:before,.annotationLayer .buttonWidgetAnnotation.checkBox input:checked:after,.annotationLayer .buttonWidgetAnnotation.radioButton input:checked:before{background-color:CanvasText;content:"";display:block;position:absolute}.annotationLayer .buttonWidgetAnnotation.checkBox input:checked:before,.annotationLayer .buttonWidgetAnnotation.checkBox input:checked:after{height:80%;left:45%;width:1px}.annotationLayer .buttonWidgetAnnotation.checkBox input:checked:before{transform:rotate(45deg)}.annotationLayer .buttonWidgetAnnotation.checkBox input:checked:after{transform:rotate(-45deg)}.annotationLayer .buttonWidgetAnnotation.radioButton input:checked:before{border-radius:50%;height:50%;left:30%;top:20%;width:50%}.annotationLayer .textWidgetAnnotation input.comb{font-family:monospace;padding-left:2px;padding-right:0}.annotationLayer .textWidgetAnnotation input.comb:focus{width:103%}.annotationLayer .buttonWidgetAnnotation:is(.checkBox,.radioButton) input{appearance:none}.annotationLayer .popupTriggerArea{height:100%;width:100%}.annotationLayer .fileAttachmentAnnotation .popupTriggerArea{position:absolute}.annotationLayer .popupWrapper{position:absolute;font-size:calc(9px * var(--total-scale-factor));width:100%;min-width:calc(180px * var(--total-scale-factor));pointer-events:none}.annotationLayer .popup{position:absolute;max-width:calc(180px * var(--total-scale-factor));background-color:#ff9;box-shadow:0 calc(2px * var(--total-scale-factor)) calc(5px * var(--total-scale-factor)) #888;border-radius:calc(2px * var(--total-scale-factor));padding:calc(6px * var(--total-scale-factor));margin-left:calc(5px * var(--total-scale-factor));cursor:pointer;font:message-box;white-space:normal;word-wrap:break-word;pointer-events:auto}.annotationLayer .popup>*{font-size:calc(9px * var(--total-scale-factor))}.annotationLayer .popup h1{display:inline-block}.annotationLayer .popupDate{display:inline-block;margin-left:calc(5px * var(--total-scale-factor))}.annotationLayer .popupContent{border-top:1px solid rgba(51,51,51,1);margin-top:calc(2px * var(--total-scale-factor));padding-top:calc(2px * var(--total-scale-factor))}.annotationLayer .richText>*{white-space:pre-wrap;font-size:calc(9px * var(--total-scale-factor))}.annotationLayer .highlightAnnotation,.annotationLayer .underlineAnnotation,.annotationLayer .squigglyAnnotation,.annotationLayer .strikeoutAnnotation,.annotationLayer .freeTextAnnotation,.annotationLayer .lineAnnotation svg line,.annotationLayer .squareAnnotation svg rect,.annotationLayer .circleAnnotation svg ellipse,.annotationLayer .polylineAnnotation svg polyline,.annotationLayer .polygonAnnotation svg polygon,.annotationLayer .caretAnnotation,.annotationLayer .inkAnnotation svg polyline,.annotationLayer .stampAnnotation,.annotationLayer .fileAttachmentAnnotation{cursor:pointer}.annotationLayer section svg{position:absolute;width:100%;height:100%;top:0;left:0}.annotationLayer .annotationTextContent{position:absolute;width:100%;height:100%;opacity:0;color:transparent;-webkit-user-select:none;user-select:none;pointer-events:none}.annotationLayer .annotationTextContent span{width:100%;display:inline-block}:root{--react-pdf-text-layer: 1;--highlight-bg-color: rgba(180, 0, 170, 1);--highlight-selected-bg-color: rgba(0, 100, 0, 1)}@media screen and (forced-colors:active){:root{--highlight-bg-color: Highlight;--highlight-selected-bg-color: ButtonText}}[data-main-rotation="90"]{transform:rotate(90deg) translateY(-100%)}[data-main-rotation="180"]{transform:rotate(180deg) translate(-100%,-100%)}[data-main-rotation="270"]{transform:rotate(270deg) translate(-100%)}.textLayer{position:absolute;text-align:initial;inset:0;overflow:hidden;line-height:1;text-size-adjust:none;forced-color-adjust:none;transform-origin:0 0;z-index:2}.textLayer :is(span,br){color:transparent;position:absolute;white-space:pre;cursor:text;margin:0;transform-origin:0 0}.textLayer span.markedContent{top:0;height:0}.textLayer .highlight{margin:-1px;padding:1px;background-color:var(--highlight-bg-color);border-radius:4px}.textLayer .highlight.appended{position:initial}.textLayer .highlight.begin{border-radius:4px 0 0 4px}.textLayer .highlight.end{border-radius:0 4px 4px 0}.textLayer .highlight.middle{border-radius:0}.textLayer .highlight.selected{background-color:var(--highlight-selected-bg-color)}.textLayer br::selection{background:transparent}.textLayer .endOfContent{display:block;position:absolute;inset:100% 0 0;z-index:-1;cursor:default;-webkit-user-select:none;user-select:none}.textLayer.selecting .endOfContent{top:0}.hiddenCanvasElement{position:absolute;top:0;left:0;width:0;height:0;display:none}[data-rmiz-ghost]{position:absolute;pointer-events:none}[data-rmiz-btn-zoom],[data-rmiz-btn-unzoom]{background-color:#000000b3;border-radius:50%;border:none;box-shadow:0 0 1px #ffffff80;color:#fff;height:40px;margin:0;outline-offset:2px;padding:9px;touch-action:manipulation;width:40px;-webkit-appearance:none;-moz-appearance:none;appearance:none}[data-rmiz-btn-zoom]:not(:focus):not(:active){position:absolute;clip:rect(0 0 0 0);clip-path:inset(50%);height:1px;overflow:hidden;pointer-events:none;white-space:nowrap;width:1px}[data-rmiz-btn-zoom]{position:absolute;inset:10px 10px auto auto;cursor:zoom-in}[data-rmiz-btn-unzoom]{position:absolute;inset:20px 20px auto auto;cursor:zoom-out;z-index:1}[data-rmiz-content=found] img,[data-rmiz-content=found] svg,[data-rmiz-content=found] [role=img],[data-rmiz-content=found] [data-zoom]{cursor:zoom-in}[data-rmiz-modal]::backdrop{display:none}[data-rmiz-modal][open]{position:fixed;width:100vw;width:100dvw;height:100vh;height:100dvh;max-width:none;max-height:none;margin:0;padding:0;border:0;background:transparent;overflow:hidden;pointer-events:all}[data-rmiz-modal-overlay]{position:absolute;inset:0;transition:background-color .3s}[data-rmiz-modal-overlay=hidden]{background-color:#fff0}[data-rmiz-modal-overlay=visible]{background-color:#fff}[data-rmiz-modal-content]{position:relative;width:100%;height:100%}[data-rmiz-modal-img]{position:absolute;cursor:zoom-out;image-rendering:high-quality;transform-origin:top left;transition:transform .3s}@media(prefers-reduced-motion:reduce){[data-rmiz-modal-overlay],[data-rmiz-modal-img]{transition-duration:.01ms!important}}

sovara-0.2.4/src/sovara/assets/web_app/assets/AttachmentPreview-h01XSt_Q.js

@@ -0,0 +1 @@
+import{r as n,j as e}from"./index-BygN1cJK.js";import{D as r,a as l,P as o,G as c}from"./DocumentPreviewModal-B9FumoYT.js";import{M as p,i as d,a as h,h as u,s as x,d as j}from"./RunRoute-rUSpBhsI.js";import"./LayoutBreadcrumb-D8Jj9PNg.js";import"./api-tVJBLHUH.js";import"./plus-CkqVCne8.js";import"./prismTheme-Bx8cYzkm.js";import"./tierState-Bq39H0kz.js";c.workerSrc=new URL("/assets/pdf.worker.min-qwK7q_zL.mjs",import.meta.url).toString();function b({attachment:a,onClick:i}){const s=`data:${a.mimeType};base64,${a.data}`,t=p[a.mimeType]??a.mimeType.split("/")[1]?.toUpperCase()??"FILE";return e.jsxs("button",{className:"attachment-thumb",onClick:i,title:a.name,children:[e.jsx("div",{className:"attachment-thumb-preview",children:d(a.mimeType)?e.jsx("img",{src:s,alt:a.name,className:"attachment-thumb-img"}):h(a.mimeType)?e.jsx(l,{file:s,loading:e.jsx("div",{className:"attachment-thumb-placeholder",children:"PDF"}),children:e.jsx(o,{pageNumber:1,width:120,renderTextLayer:!1,renderAnnotationLayer:!1})}):e.jsx("div",{className:"attachment-thumb-placeholder",children:t})}),e.jsxs("div",{className:"attachment-thumb-label",children:[e.jsx("span",{className:"attachment-thumb-ext",children:t}),e.jsx("span",{className:"attachment-thumb-name",children:a.name})]})]})}function k({attachments:a}){const[i,s]=n.useState(null);if(a.length===0)return null;function t(m){u(m.mimeType)?s(m):x(j(m.data,{mime_type:m.mimeType,filename:m.name})||{data:m.data,mimeType:m.mimeType,type:"unknown",name:m.name})}return e.jsxs(e.Fragment,{children:[e.jsx("div",{className:"attachment-strip",children:a.map(m=>e.jsx(b,{attachment:m,onClick:()=>t(m)},m.id))}),i&&e.jsx(r,{attachment:i,onClose:()=>s(null)})]})}export{k as AttachmentStrip};