refua-studio 0.6.0__tar.gz

refua_studio-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JJ Ben-Joseph
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

refua_studio-0.6.0/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: refua-studio
+Version: 0.6.0
+Summary: Web control plane for Refua campaign orchestration and scientific execution.
+Author-email: JJ Ben-Joseph <jj@tensorspace.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://agentcures.com/
+Project-URL: Repository, https://github.com/agentcures/refua
+Project-URL: Documentation, https://github.com/agentcures/refua#readme
+Project-URL: Issues, https://github.com/agentcures/refua/issues
+Keywords: drug discovery,refua,campaign,control plane,studio
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: <3.15,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# refua-studio
+
+`refua-studio` is the Refua web control plane for planning and running discovery campaigns.
+
+It provides:
+
+- Mission control UI for planning (`plan`), execution (`run`), and autonomous loops (`run-autonomous` behavior)
+- JSON plan editor with validation and direct execution
+- Portfolio ranking UI for disease program prioritization
+- Built-in objective/plan/portfolio templates loaded from workspace examples
+- Promising drug portfolio section with candidate cards, scores, metrics, and full detail view
+- Persistent background job history (SQLite)
+- Job lifecycle operations (filter, cancel queued jobs, clear finished jobs)
+- Runtime/tool introspection with graceful fallback when heavy ML deps are unavailable
+
+This project is designed to reuse existing workspace components:
+
+- `ClawCures` for planning, policy checks, orchestration, and portfolio ranking
+- `refua-mcp` for tool execution when runtime dependencies are installed
+
+## Install
+
+```bash
+cd path/to/refua-studio
+pip install -e .
+```
+
+## Run
+
+```bash
+refua-studio --host 127.0.0.1 --port 8787 --open-browser
+```
+
+Or from source without install:
+
+```bash
+cd path/to/refua-studio
+PYTHONPATH=src python -m refua_studio --host 127.0.0.1 --port 8787
+```
+
+## Configuration
+
+Studio uses the same OpenClaw-related environment variables as `ClawCures`:
+
+- `REFUA_CAMPAIGN_OPENCLAW_BASE_URL` (default: `http://127.0.0.1:18789`)
+- `REFUA_CAMPAIGN_OPENCLAW_MODEL` (default: `openclaw:main`)
+- `REFUA_CAMPAIGN_TIMEOUT_SECONDS` (default: `180`)
+- `OPENCLAW_GATEWAY_TOKEN` or `REFUA_CAMPAIGN_OPENCLAW_TOKEN`
+
+CLI flags:
+
+- `--host`
+- `--port`
+- `--data-dir` (default: `.refua-studio`)
+- `--workspace-root` (defaults to parent workspace)
+- `--max-workers` (background job concurrency)
+
+## API Endpoints
+
+- `GET /api/health`
+- `GET /api/config`
+- `GET /api/tools`
+- `GET /api/examples`
+- `GET /api/drug-portfolio?min_score=50&limit=60`
+- `GET /api/jobs?limit=80&status=running,failed`
+- `GET /api/jobs/{job_id}`
+- `POST /api/jobs/{job_id}/cancel`
+- `POST /api/jobs/clear`
+- `POST /api/plan`
+- `POST /api/run`
+- `POST /api/plan/validate`
+- `POST /api/plan/execute`
+- `POST /api/portfolio/rank`
+
+### `POST /api/run` payload
+
+```json
+{
+  "objective": "Design an initial campaign against KRAS G12D",
+  "system_prompt": null,
+  "dry_run": false,
+  "async_mode": true,
+  "autonomous": false,
+  "max_rounds": 3,
+  "max_calls": 10,
+  "allow_skip_validate_first": false,
+  "plan": null
+}
+```
+
+## Background Jobs
+
+Jobs are persisted in SQLite at:
+
+- `<data-dir>/studio.db`
+
+Each job records request payload, status transitions (`queued` -> `running` -> `completed`/`failed`), result JSON, and error text.
+`cancelled` is also tracked when queued jobs are cancelled before execution.
+
+## Runtime Behavior
+
+- If `refua-mcp` runtime dependencies are available, Studio executes plans through `RefuaMcpAdapter`.
+- If unavailable, Studio falls back to a static tool list for planning/validation and emits warnings.
+- Dry-run workflows and policy validation remain usable even without heavy runtime dependencies.
+
+## Tests
+
+```bash
+cd path/to/refua-studio
+python -m unittest discover -s tests -v
+```
+
+## Project Layout
+
+```text
+refua-studio/
+  src/refua_studio/
+    app.py
+    bridge.py
+    cli.py
+    config.py
+    runner.py
+    storage.py
+    static/
+      index.html
+      app.js
+      styles.css
+  tests/
+```
+
+## Notes
+
+- The Studio UI is a static single-page app served by the Python server.
+- No third-party web framework is required.
+- This keeps installation lightweight while still integrating with the existing Refua ecosystem.

refua_studio-0.6.0/README.md

@@ -0,0 +1,135 @@
+# refua-studio
+
+`refua-studio` is the Refua web control plane for planning and running discovery campaigns.
+
+It provides:
+
+- Mission control UI for planning (`plan`), execution (`run`), and autonomous loops (`run-autonomous` behavior)
+- JSON plan editor with validation and direct execution
+- Portfolio ranking UI for disease program prioritization
+- Built-in objective/plan/portfolio templates loaded from workspace examples
+- Promising drug portfolio section with candidate cards, scores, metrics, and full detail view
+- Persistent background job history (SQLite)
+- Job lifecycle operations (filter, cancel queued jobs, clear finished jobs)
+- Runtime/tool introspection with graceful fallback when heavy ML deps are unavailable
+
+This project is designed to reuse existing workspace components:
+
+- `ClawCures` for planning, policy checks, orchestration, and portfolio ranking
+- `refua-mcp` for tool execution when runtime dependencies are installed
+
+## Install
+
+```bash
+cd path/to/refua-studio
+pip install -e .
+```
+
+## Run
+
+```bash
+refua-studio --host 127.0.0.1 --port 8787 --open-browser
+```
+
+Or from source without install:
+
+```bash
+cd path/to/refua-studio
+PYTHONPATH=src python -m refua_studio --host 127.0.0.1 --port 8787
+```
+
+## Configuration
+
+Studio uses the same OpenClaw-related environment variables as `ClawCures`:
+
+- `REFUA_CAMPAIGN_OPENCLAW_BASE_URL` (default: `http://127.0.0.1:18789`)
+- `REFUA_CAMPAIGN_OPENCLAW_MODEL` (default: `openclaw:main`)
+- `REFUA_CAMPAIGN_TIMEOUT_SECONDS` (default: `180`)
+- `OPENCLAW_GATEWAY_TOKEN` or `REFUA_CAMPAIGN_OPENCLAW_TOKEN`
+
+CLI flags:
+
+- `--host`
+- `--port`
+- `--data-dir` (default: `.refua-studio`)
+- `--workspace-root` (defaults to parent workspace)
+- `--max-workers` (background job concurrency)
+
+## API Endpoints
+
+- `GET /api/health`
+- `GET /api/config`
+- `GET /api/tools`
+- `GET /api/examples`
+- `GET /api/drug-portfolio?min_score=50&limit=60`
+- `GET /api/jobs?limit=80&status=running,failed`
+- `GET /api/jobs/{job_id}`
+- `POST /api/jobs/{job_id}/cancel`
+- `POST /api/jobs/clear`
+- `POST /api/plan`
+- `POST /api/run`
+- `POST /api/plan/validate`
+- `POST /api/plan/execute`
+- `POST /api/portfolio/rank`
+
+### `POST /api/run` payload
+
+```json
+{
+  "objective": "Design an initial campaign against KRAS G12D",
+  "system_prompt": null,
+  "dry_run": false,
+  "async_mode": true,
+  "autonomous": false,
+  "max_rounds": 3,
+  "max_calls": 10,
+  "allow_skip_validate_first": false,
+  "plan": null
+}
+```
+
+## Background Jobs
+
+Jobs are persisted in SQLite at:
+
+- `<data-dir>/studio.db`
+
+Each job records request payload, status transitions (`queued` -> `running` -> `completed`/`failed`), result JSON, and error text.
+`cancelled` is also tracked when queued jobs are cancelled before execution.
+
+## Runtime Behavior
+
+- If `refua-mcp` runtime dependencies are available, Studio executes plans through `RefuaMcpAdapter`.
+- If unavailable, Studio falls back to a static tool list for planning/validation and emits warnings.
+- Dry-run workflows and policy validation remain usable even without heavy runtime dependencies.
+
+## Tests
+
+```bash
+cd path/to/refua-studio
+python -m unittest discover -s tests -v
+```
+
+## Project Layout
+
+```text
+refua-studio/
+  src/refua_studio/
+    app.py
+    bridge.py
+    cli.py
+    config.py
+    runner.py
+    storage.py
+    static/
+      index.html
+      app.js
+      styles.css
+  tests/
+```
+
+## Notes
+
+- The Studio UI is a static single-page app served by the Python server.
+- No third-party web framework is required.
+- This keeps installation lightweight while still integrating with the existing Refua ecosystem.

refua_studio-0.6.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "refua-studio"
+version = "0.6.0"
+description = "Web control plane for Refua campaign orchestration and scientific execution."
+readme = "README.md"
+requires-python = ">=3.11,<3.15"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "JJ Ben-Joseph", email = "jj@tensorspace.ai"}]
+keywords = [
+  "drug discovery",
+  "refua",
+  "campaign",
+  "control plane",
+  "studio"
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Science/Research",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Scientific/Engineering :: Bio-Informatics",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://agentcures.com/"
+Repository = "https://github.com/agentcures/refua"
+Documentation = "https://github.com/agentcures/refua#readme"
+Issues = "https://github.com/agentcures/refua/issues"
+
+[project.scripts]
+refua-studio = "refua_studio.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+refua_studio = ["static/*"]
+
+[tool.setuptools.exclude-package-data]
+"*" = ["*.py[cod]", "__pycache__/*"]

refua_studio-0.6.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

refua_studio-0.6.0/src/refua_studio/__init__.py

@@ -0,0 +1,5 @@
+"""Refua Studio package."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.6.0"

refua_studio-0.6.0/src/refua_studio/__main__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from refua_studio.cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())