nexura-studio 0.4.0__tar.gz

nexura_studio-0.4.0/.gitignore

@@ -0,0 +1,80 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Testing and linting
+.pytest_cache/
+.coverage
+htmlcov/
+.ruff_cache/
+.mypy_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Local databases and run state (never commit)
+*.sqlite3
+*.sqlite3-shm
+*.sqlite3-wal
+/:memory:
+.agy/
+
+# Node / Studio build output
+node_modules/
+studio-web/dist/
+clients/typescript/dist/
+studio-web/test-results/
+studio-web/playwright-report/
+*.tgz
+
+# Never commit (added 2026-10-18 before the first local git commit)
+# Local databases, trigger encryption keys and other key material
+*.db
+*.key
+*.sqlite3.trigger.key
+.env
+.env.*
+!.env.example
+*.pem
+# Local run logs at the project root (gate, suite, browser)
+*.log
+.*.log
+# Autopilot scratch (backups, repros, agent prompts); history lives in oss-completion-blueprint/
+/.autopilot/
+# Tool caches and local agent state
+.mypy_cache/
+.claude/
+.playwright-mcp/
+# Closed edition: its own nested local git repository, never part of this one
+/enterprise/
+# Internal review archive from the founder; not part of the public repository
+/codex reviews/
+# Demo-video recorder (local only; videos go to .autopilot)
+studio-web/demos/
+.gstack/

nexura_studio-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Liceron
+
+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.

nexura_studio-0.4.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.5
+Name: nexura-studio
+Version: 0.4.0
+Summary: Nexura Studio: a local web page to build, run and approve nexura-runtime workflows, and its nexura-studio launcher.
+Project-URL: Homepage, https://github.com/Liceron/nexura
+Project-URL: Documentation, https://github.com/Liceron/nexura/blob/main/docs/README.md
+Project-URL: Source, https://github.com/Liceron/nexura
+Project-URL: Issues, https://github.com/Liceron/nexura/issues
+Project-URL: Changelog, https://github.com/Liceron/nexura/blob/main/CHANGELOG.md
+Author-email: Liceron <info@liceron.in>
+License-Expression: MIT AND OFL-1.1
+License-File: LICENSE
+License-File: src/nexura_studio/static/fonts/OFL.txt
+Keywords: agents,approvals,fastapi,studio,workflows
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: <3.13,>=3.12
+Requires-Dist: fastapi<1.0.0,>=0.111.0
+Requires-Dist: nexura-agents==0.4.0
+Requires-Dist: nexura-runtime==0.4.0
+Requires-Dist: pydantic<3.0.0,>=2.7.0
+Requires-Dist: uvicorn<1.0.0,>=0.30.0
+Description-Content-Type: text/markdown
+
+# Nexura Studio
+
+The older local workflow Studio and its nexura-studio launcher.
+
+## Install
+
+```bash
+pip install nexura-studio
+```
+
+Alpha (0.4): `pip install nexura-studio`. See [package installation](https://github.com/Liceron/nexura/blob/main/docs/packages.md).
+
+## Minimal example
+
+This example uses an in-process ASGI transport and a disposable database, without a listener. Runs use the real workflow engine; built-in demo data is synthetic. The React Studio/API uses `nexura-runtime[studio]` instead. Without this package, `nexura_runtime.studio.create_app()` raises `MissingDependencyError` naming `nexura-studio`.
+
+```python
+import asyncio
+import tempfile
+from pathlib import Path
+
+import httpx
+
+from nexura_studio import create_app
+
+
+async def main() -> None:
+    with tempfile.TemporaryDirectory() as tmp:
+        app = create_app(db_path=Path(tmp) / "studio.sqlite3")
+        async with httpx.AsyncClient(
+            transport=httpx.ASGITransport(app=app),
+            base_url="http://127.0.0.1",
+            headers={"X-Nexura-Session": app.state.session_token},
+        ) as client:
+            modules = (await client.get("/api/v1/modules")).json()["modules"]
+            print(len(modules), "modules, for example", sorted(m["name"] for m in modules)[0])
+            page = await client.get("/")
+            assert page.status_code == 200 and "nexura-session" in page.text
+
+
+asyncio.run(main())
+```
+
+## Status and limits
+
+> Status: **alpha** (0.4), Python 3.12 (the same as `nexura-runtime`). Single user, local
+> use; it has not had an external security review.
+
+Single user, this machine only. The launcher defaults to `127.0.0.1` and refuses non-loopback `--host` without `NEXURA_STUDIO_TOKEN` or the explicit insecure opt-in. State changes require the session token: it stops other web pages, not local programs that can read it. An insecure opt-in does not make a public endpoint safe.
+
+## Documentation and licence
+
+[Main documentation](https://github.com/Liceron/nexura/blob/main/docs/README.md) · [Full guide](https://github.com/Liceron/nexura/blob/main/docs/studio-and-service.md). MIT, Copyright (c) 2026 Liceron. See [LICENSE](https://github.com/Liceron/nexura/blob/main/packages/nexura-studio/LICENSE). Bundled Noto Sans Devanagari is SIL OFL 1.1; see its `OFL.txt`.

nexura_studio-0.4.0/README.md

@@ -0,0 +1,53 @@
+# Nexura Studio
+
+The older local workflow Studio and its nexura-studio launcher.
+
+## Install
+
+```bash
+pip install nexura-studio
+```
+
+Alpha (0.4): `pip install nexura-studio`. See [package installation](https://github.com/Liceron/nexura/blob/main/docs/packages.md).
+
+## Minimal example
+
+This example uses an in-process ASGI transport and a disposable database, without a listener. Runs use the real workflow engine; built-in demo data is synthetic. The React Studio/API uses `nexura-runtime[studio]` instead. Without this package, `nexura_runtime.studio.create_app()` raises `MissingDependencyError` naming `nexura-studio`.
+
+```python
+import asyncio
+import tempfile
+from pathlib import Path
+
+import httpx
+
+from nexura_studio import create_app
+
+
+async def main() -> None:
+    with tempfile.TemporaryDirectory() as tmp:
+        app = create_app(db_path=Path(tmp) / "studio.sqlite3")
+        async with httpx.AsyncClient(
+            transport=httpx.ASGITransport(app=app),
+            base_url="http://127.0.0.1",
+            headers={"X-Nexura-Session": app.state.session_token},
+        ) as client:
+            modules = (await client.get("/api/v1/modules")).json()["modules"]
+            print(len(modules), "modules, for example", sorted(m["name"] for m in modules)[0])
+            page = await client.get("/")
+            assert page.status_code == 200 and "nexura-session" in page.text
+
+
+asyncio.run(main())
+```
+
+## Status and limits
+
+> Status: **alpha** (0.4), Python 3.12 (the same as `nexura-runtime`). Single user, local
+> use; it has not had an external security review.
+
+Single user, this machine only. The launcher defaults to `127.0.0.1` and refuses non-loopback `--host` without `NEXURA_STUDIO_TOKEN` or the explicit insecure opt-in. State changes require the session token: it stops other web pages, not local programs that can read it. An insecure opt-in does not make a public endpoint safe.
+
+## Documentation and licence
+
+[Main documentation](https://github.com/Liceron/nexura/blob/main/docs/README.md) · [Full guide](https://github.com/Liceron/nexura/blob/main/docs/studio-and-service.md). MIT, Copyright (c) 2026 Liceron. See [LICENSE](https://github.com/Liceron/nexura/blob/main/packages/nexura-studio/LICENSE). Bundled Noto Sans Devanagari is SIL OFL 1.1; see its `OFL.txt`.

nexura_studio-0.4.0/pyproject.toml

@@ -0,0 +1,60 @@
+[project]
+name = "nexura-studio"
+version = "0.4.0"
+description = "Nexura Studio: a local web page to build, run and approve nexura-runtime workflows, and its nexura-studio launcher."
+readme = "README.md"
+requires-python = ">=3.12,<3.13"
+# The bundled Noto Sans Devanagari font is under the SIL Open Font License 1.1.
+license = "MIT AND OFL-1.1"
+license-files = ["LICENSE", "src/nexura_studio/static/fonts/OFL.txt"]
+authors = [{ name = "Liceron", email = "info@liceron.in" }]
+keywords = ["agents", "workflows", "studio", "approvals", "fastapi"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Framework :: FastAPI",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+# Same version as the runtime it serves. FastAPI and uvicorn have the same constraints as the
+# runtime's `studio` extra, which the REST service (`nexura-runtime serve`) still uses.
+dependencies = [
+    "nexura-runtime==0.4.0",
+    "nexura-agents==0.4.0",
+    "fastapi>=0.111.0,<1.0.0",
+    "uvicorn>=0.30.0,<1.0.0",
+    "pydantic>=2.7.0,<3.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Liceron/nexura"
+Documentation = "https://github.com/Liceron/nexura/blob/main/docs/README.md"
+Source = "https://github.com/Liceron/nexura"
+Issues = "https://github.com/Liceron/nexura/issues"
+Changelog = "https://github.com/Liceron/nexura/blob/main/CHANGELOG.md"
+
+[project.scripts]
+nexura-studio = "nexura_studio.cli:main"
+
+[project.entry-points."nexura.commands"]
+studio = "nexura_studio.commands:main"
+
+[tool.uv.sources]
+# Development inside the monorepo uses the workspace copies.
+nexura-runtime = { workspace = true }
+nexura-agents = { workspace = true }
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nexura_studio"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/README.md", "/LICENSE", "/pyproject.toml"]
+exclude = [
+    "**/__pycache__", "**/*.pyc",
+    "**/*blueprint*/**", "**/internal/**", "**/product/**", "**/.autopilot/**",
+]

nexura_studio-0.4.0/src/nexura_studio/__init__.py

@@ -0,0 +1,36 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 Liceron
+"""Nexura Studio: the local workflow and approval web page and its launcher.
+
+Distributed as ``nexura-studio`` (it depends on ``nexura-runtime`` with FastAPI and uvicorn).
+The ``nexura-studio`` command starts it; ``create_app`` builds the FastAPI application. The
+run store, built-in demo modules, traces and security middleware it uses are part of
+``nexura-runtime`` (``nexura_runtime.studio``), which the REST service shares.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+try:
+    import fastapi  # noqa: F401
+    import uvicorn  # noqa: F401
+
+    _STUDIO_AVAILABLE = True
+except ImportError:
+    _STUDIO_AVAILABLE = False
+
+
+def create_app(*args: Any, **kwargs: Any) -> Any:
+    """Create configured FastAPI app, checking for optional studio extra dependencies."""
+    if not _STUDIO_AVAILABLE:
+        raise ImportError(
+            "Nexura Studio requires the 'studio' extra dependencies (fastapi, uvicorn).\n"
+            "Please install them with: pip install 'nexura-runtime[studio]'"
+        )
+    from nexura_studio.server import create_app as _create_app
+
+    return _create_app(*args, **kwargs)
+
+
+__all__ = ["create_app"]

nexura_studio-0.4.0/src/nexura_studio/api/__init__.py

@@ -0,0 +1,3 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 Liceron
+"""REST routes of the Studio launcher (workflows, runs, modules; traces come from the runtime)."""

nexura_studio-0.4.0/src/nexura_studio/api/modules.py

@@ -0,0 +1,44 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 Liceron
+"""API endpoints for inspecting available registered workflow modules."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from fastapi import APIRouter, Request
+
+from nexura_runtime.studio.builtin_modules import get_default_module_metadata
+from nexura_runtime.workflow import ModuleRegistry
+
+router = APIRouter(prefix="/modules", tags=["modules"])
+
+
+@router.get("", response_model=dict[str, list[dict[str, Any]]])
+async def list_modules(request: Request) -> dict[str, list[dict[str, Any]]]:
+    """List all trusted Python modules registered in this Studio instance."""
+    registry: ModuleRegistry = request.app.state.registry
+    metadata_lookup = {m["name"]: m for m in get_default_module_metadata()}
+
+    modules: list[dict[str, Any]] = []
+    # Inspect registered handlers
+    for name, fn in registry._handlers.items():
+        meta = metadata_lookup.get(name)
+        if meta:
+            modules.append(dict(meta))
+        else:
+            doc = fn.__doc__ or "Custom developer-registered Python handler."
+            modules.append(
+                {
+                    "name": name,
+                    "title": name.replace("_", " ").title(),
+                    "description": doc.strip().split("\n")[0],
+                    "disclaimer": "Custom Trusted Python Handler (Registered at create_app)",
+                    "is_synthetic": False,
+                    "parameters": [],
+                    "outputs": [],
+                    "branches": [],
+                }
+            )
+
+    return {"modules": modules}

nexura_studio-0.4.0/src/nexura_studio/api/router.py

@@ -0,0 +1,18 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 Liceron
+"""Main API v1 router combining modules, workflows, and runs endpoints."""
+
+from __future__ import annotations
+
+from fastapi import APIRouter
+
+from nexura_runtime.studio.api.traces import router as traces_router
+from nexura_studio.api.modules import router as modules_router
+from nexura_studio.api.runs import router as runs_router
+from nexura_studio.api.workflows import router as workflows_router
+
+api_v1_router = APIRouter(prefix="/api/v1")
+api_v1_router.include_router(modules_router)
+api_v1_router.include_router(workflows_router)
+api_v1_router.include_router(runs_router)
+api_v1_router.include_router(traces_router)