dulus 0.2.40__tar.gz → 0.2.42__tar.gz

{dulus-0.2.40/dulus.egg-info → dulus-0.2.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dulus
-Version: 0.2.40
+Version: 0.2.42
 Summary: Spanish-first multi-provider AI CLI — 14 NVIDIA models free, Mesa Redonda, voice, TTS, RTK token reducer, MemPalace
 Author: KevRojo
 License: GPL-3.0
@@ -22,6 +22,7 @@ Classifier: Topic :: Terminals
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+License-File: license_manager.py
 Requires-Dist: anthropic>=0.40.0
 Requires-Dist: openai>=1.30.0
 Requires-Dist: httpx>=0.27.0
@@ -68,7 +69,7 @@ SET /sticky_input ON since the first run for the best experience!
   <a href="https://pypi.org/project/dulus/"><img src="https://static.pepy.tech/badge/dulus?style=flat-square" alt="downloads"/></a>
   <img src="https://img.shields.io/badge/python-3.11+-ff6b1f?style=flat-square&labelColor=07070a" alt="python"/>
   <img src="https://img.shields.io/badge/license-GPLv3-ff6b1f?style=flat-square&labelColor=07070a" alt="license"/>
-  <img src="https://img.shields.io/badge/version-v0.2.30-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
+  <img src="https://img.shields.io/badge/version-v0.2.42-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
   <img src="https://img.shields.io/badge/providers-11-ff6b1f?style=flat-square&labelColor=07070a" alt="providers"/>
   <img src="https://img.shields.io/badge/tools-27-ff6b1f?style=flat-square&labelColor=07070a" alt="tools"/>
   <img src="https://img.shields.io/badge/tests-263+-ff6b1f?style=flat-square&labelColor=07070a" alt="tests"/>
@@ -226,6 +227,13 @@ echo "explain this diff" | git diff | dulus -p --accept-all
 
 <p align="center"><sub>↑ session boot. soul loaded, gold memory warm, shell sniffed. the little circles are real buttons on your Mac.</sub></p>
 
+### 💻 Dulus OS (Sandbox)
+> [!NOTE]
+> **Experimental features:** The folder `sandbox/` contains the early implementation of **Dulus OS** — a mini-operating system that runs entirely in your browser. It is currently in heavy development and not 100% functional yet. It will serve as a secure, isolated environment for browser-based tool execution and visualizations.
+
+---
+
+
 ---
 
 <p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/sec-features.svg" alt="Features" width="100%"></p>

{dulus-0.2.40 → dulus-0.2.42}/README.md

@@ -22,7 +22,7 @@ SET /sticky_input ON since the first run for the best experience!
   <a href="https://pypi.org/project/dulus/"><img src="https://static.pepy.tech/badge/dulus?style=flat-square" alt="downloads"/></a>
   <img src="https://img.shields.io/badge/python-3.11+-ff6b1f?style=flat-square&labelColor=07070a" alt="python"/>
   <img src="https://img.shields.io/badge/license-GPLv3-ff6b1f?style=flat-square&labelColor=07070a" alt="license"/>
-  <img src="https://img.shields.io/badge/version-v0.2.30-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
+  <img src="https://img.shields.io/badge/version-v0.2.42-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
   <img src="https://img.shields.io/badge/providers-11-ff6b1f?style=flat-square&labelColor=07070a" alt="providers"/>
   <img src="https://img.shields.io/badge/tools-27-ff6b1f?style=flat-square&labelColor=07070a" alt="tools"/>
   <img src="https://img.shields.io/badge/tests-263+-ff6b1f?style=flat-square&labelColor=07070a" alt="tests"/>
@@ -180,6 +180,13 @@ echo "explain this diff" | git diff | dulus -p --accept-all
 
 <p align="center"><sub>↑ session boot. soul loaded, gold memory warm, shell sniffed. the little circles are real buttons on your Mac.</sub></p>
 
+### 💻 Dulus OS (Sandbox)
+> [!NOTE]
+> **Experimental features:** The folder `sandbox/` contains the early implementation of **Dulus OS** — a mini-operating system that runs entirely in your browser. It is currently in heavy development and not 100% functional yet. It will serve as a secure, isolated environment for browser-based tool execution and visualizations.
+
+---
+
+
 ---
 
 <p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/sec-features.svg" alt="Features" width="100%"></p>

{dulus-0.2.40 → dulus-0.2.42}/common.py

@@ -3,7 +3,7 @@ import json
 
 # ── Import slash completer helpers ──
 try:
-    from backend.ui.input import (
+    from ui.input import (
         setup as _setup_slash_complete,
         read_line as _read_line_pt,
         reset_session as _reset_pt_session,

{dulus-0.2.40 → dulus-0.2.42}/data/context.json

@@ -9,22 +9,52 @@
   "project": {
     "name": "Dulus Command Center",
     "repo_stats": {
-      "files": 241,
-      "lines": 110197,
+      "files": 26697,
+      "lines": 3602498,
       "languages": {
         ".example": 5,
-        ".py": 58599,
-        ".html": 14582,
-        "no_ext": 1158,
+        "no_ext": 16410,
+        ".py": 60171,
+        ".html": 15960,
         ".in": 2,
         ".toml": 123,
-        ".md": 2050,
-        ".txt": 40,
-        ".TAG": 4,
-        ".json": 728,
-        ".svg": 1123,
-        ".png": 31639,
-        ".sh": 144
+        ".md": 79646,
+        ".txt": 1018,
+        ".json": 133634,
+        ".whl": 17908,
+        ".gz": 18064,
+        ".svg": 1168,
+        ".png": 157513,
+        ".sh": 144,
+        ".js": 1992568,
+        ".ts": 570599,
+        ".log": 1,
+        ".jpg": 1076,
+        ".tsx": 34508,
+        ".css": 2848,
+        ".cmd": 476,
+        ".ps1": 784,
+        ".tsbuildinfo": 2,
+        ".mts": 29541,
+        ".yml": 250,
+        ".markdown": 763,
+        ".flow": 21999,
+        ".cjs": 150052,
+        ".cts": 44618,
+        ".map": 5059,
+        ".mjs": 102525,
+        ".BSD": 59,
+        ".lock": 2598,
+        ".nix": 20,
+        ".bnf": 32,
+        ".coffee": 1,
+        ".1": 164,
+        ".php": 156,
+        ".jst": 1840,
+        ".def": 534,
+        ".node": 34828,
+        ".snap": 4138,
+        ".exe": 98693
       }
     },
     "recent_commits": [],

{dulus-0.2.40 → dulus-0.2.42/dulus.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dulus
-Version: 0.2.40
+Version: 0.2.42
 Summary: Spanish-first multi-provider AI CLI — 14 NVIDIA models free, Mesa Redonda, voice, TTS, RTK token reducer, MemPalace
 Author: KevRojo
 License: GPL-3.0
@@ -22,6 +22,7 @@ Classifier: Topic :: Terminals
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+License-File: license_manager.py
 Requires-Dist: anthropic>=0.40.0
 Requires-Dist: openai>=1.30.0
 Requires-Dist: httpx>=0.27.0
@@ -68,7 +69,7 @@ SET /sticky_input ON since the first run for the best experience!
   <a href="https://pypi.org/project/dulus/"><img src="https://static.pepy.tech/badge/dulus?style=flat-square" alt="downloads"/></a>
   <img src="https://img.shields.io/badge/python-3.11+-ff6b1f?style=flat-square&labelColor=07070a" alt="python"/>
   <img src="https://img.shields.io/badge/license-GPLv3-ff6b1f?style=flat-square&labelColor=07070a" alt="license"/>
-  <img src="https://img.shields.io/badge/version-v0.2.30-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
+  <img src="https://img.shields.io/badge/version-v0.2.42-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
   <img src="https://img.shields.io/badge/providers-11-ff6b1f?style=flat-square&labelColor=07070a" alt="providers"/>
   <img src="https://img.shields.io/badge/tools-27-ff6b1f?style=flat-square&labelColor=07070a" alt="tools"/>
   <img src="https://img.shields.io/badge/tests-263+-ff6b1f?style=flat-square&labelColor=07070a" alt="tests"/>
@@ -226,6 +227,13 @@ echo "explain this diff" | git diff | dulus -p --accept-all
 
 <p align="center"><sub>↑ session boot. soul loaded, gold memory warm, shell sniffed. the little circles are real buttons on your Mac.</sub></p>
 
+### 💻 Dulus OS (Sandbox)
+> [!NOTE]
+> **Experimental features:** The folder `sandbox/` contains the early implementation of **Dulus OS** — a mini-operating system that runs entirely in your browser. It is currently in heavy development and not 100% functional yet. It will serve as a secure, isolated environment for browser-based tool execution and visualizations.
+
+---
+
+
 ---
 
 <p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/sec-features.svg" alt="Features" width="100%"></p>

{dulus-0.2.40 → dulus-0.2.42}/dulus.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ context.py
 dulus.py
 dulus_gui.py
 input.py
+license_manager.py
 offload_helper.py
 providers.py
 pyproject.toml

{dulus-0.2.40 → dulus-0.2.42}/dulus.py

@@ -115,6 +115,8 @@ Slash commands in REPL:
   /kimi_chats       List recent Kimi conversations
   /webchat [port]   Spawn web chat UI (background Flask server)
   /webchat stop     Kill the webchat server
+  /sandbox          Open Dulus Sandbox OS in browser (starts webchat if needed)
+  /sandbox stop     Stop the webchat server
   /rtk [on|off]     Toggle RTK token-optimized shell command rewriting
   /exit /quit Exit
 """
@@ -1828,6 +1830,46 @@ def cmd_webchat(args: str, state, config) -> bool:
     info(f"WebChat spawn timed out -- try opening {local_url} manually or check :{port}")
     return True
 
+
+def cmd_sandbox(args: str, state, config) -> bool:
+    """Open the Dulus Sandbox OS in the browser.
+
+    /sandbox          — Ensure webchat is running, open /sandbox in browser
+    /sandbox stop     — Alias for /webchat stop
+    """
+    import webbrowser, time, urllib.request
+
+    arg = (args or "").strip().lower()
+
+    if arg in ("stop", "kill", "off"):
+        return cmd_webchat("stop", state, config)
+
+    # Make sure webchat is running first
+    import webchat_server
+    port = config.get("_webchat_port", 5000)
+
+    def _wc_alive(p):
+        try:
+            urllib.request.urlopen(f"http://127.0.0.1:{p}/api/health", timeout=0.5).read(1)
+            return True
+        except Exception:
+            return False
+
+    if not _wc_alive(port):
+        ok("Starting WebChat first...")
+        cmd_webchat("", state, config)
+        # Wait up to 5s for it to be ready
+        for _ in range(20):
+            if _wc_alive(port):
+                break
+            time.sleep(0.25)
+
+    sandbox_url = f"http://127.0.0.1:{port}/sandbox"
+    ok(f"Opening Sandbox OS -> {sandbox_url}")
+    webbrowser.open(sandbox_url)
+    info("Mini OS running in your browser. Use /sandbox stop to shut down the server.")
+    return True
+
 def cmd_gui(_args: str, _state, config) -> bool:
     """Launch the desktop GUI from the REPL."""
     try:
@@ -7440,6 +7482,7 @@ COMMANDS = {
     "voice":       cmd_voice,
     "git":         cmd_git,
     "webchat":     cmd_webchat,
+    "sandbox":     cmd_sandbox,
     "gui":         cmd_gui,
     "brave":       cmd_brave,
     "rtk":         cmd_rtk,
@@ -7579,7 +7622,8 @@ _CMD_META: dict[str, tuple[str, list[str]]] = {
     "gemini_chats": ("Manage Gemini Web conversations",    ["new"]),
     "gemini_harvest": ("Harvest Gemini Web cookies (alias)", []),
     "harvest-claude": ("Harvest Claude.ai cookies (alias)", []),
-    "webchat":       ("Spawn web chat UI",                 ["stop"]),
+    "webchat":       ("Spawn web chat UI",                 ["stop", "lan"]),
+    "sandbox":       ("Open Dulus Sandbox OS in browser",  ["stop"]),
     "gui":           ("Launch desktop GUI",                 []),
 }
 

dulus-0.2.42/license_manager.py

@@ -0,0 +1,187 @@
+"""Dulus License Manager — Offline-first key validation + feature gating.
+
+Tiers:
+  FREE      No key required. Limited tool calls, local providers only.
+  PRO       $15/mo. Full features, BYOK, priority support.
+  ENTERPRISE $50/mo. Team features + admin dashboard + SSO (future).
+
+Key format (offline):
+  DULUS-<base64(json_payload + ":" + hmac_signature)>
+
+The secret lives in ~/.dulus/.license_secret (never commit this file).
+If the secret file is missing we fall back to a hardcoded dev-key so
+Kev can develop without friction, but distribution builds MUST bundle
+a real secret via CI env var or PyInstaller --add-data.
+"""
+from __future__ import annotations
+
+import base64
+import hashlib
+import hmac
+import json
+import os
+import sys
+import time
+from pathlib import Path
+from typing import Optional
+
+# ── Secret resolution ───────────────────────────────────────────────────────
+# 1. CI / build-time env var   (safest for releases)
+# 2. ~/.dulus/.license_secret (Kev's local dev key)
+# 3. Fallback dev secret       (NEVER use in production builds)
+_LICENSE_SECRET = os.environ.get("DULUS_LICENSE_SECRET", "")
+if not _LICENSE_SECRET:
+    _secret_path = Path.home() / ".dulus" / ".license_secret"
+    if _secret_path.exists():
+        _LICENSE_SECRET = _secret_path.read_text().strip()
+    else:
+        _LICENSE_SECRET = "dulus-dev-secret-do-not-distribute"
+        import warnings
+        warnings.warn(
+            "DULUS_LICENSE_SECRET not set — using hardcoded DEV secret. "
+            "Generated keys will be trivially forgeable in production!",
+            RuntimeWarning,
+            stacklevel=2,
+        )
+
+
+class LicenseTier:
+    FREE = "free"
+    PRO = "pro"
+    ENTERPRISE = "enterprise"
+
+
+class LicenseManager:
+    """Parse and validate a Dulus license key."""
+
+    def __init__(self, key: Optional[str] = None):
+        self.raw_key = key or ""
+        self.tier = LicenseTier.FREE
+        self.expiry: float = 0.0
+        self.features: list[str] = []
+        self.valid = False
+        self.error: Optional[str] = None
+
+        if self.raw_key:
+            self._validate()
+
+    # ── validation core ─────────────────────────────────────────────────────
+
+    def _validate(self) -> None:
+        if not self.raw_key.startswith("DULUS-"):
+            self.error = "Invalid key prefix"
+            return
+
+        try:
+            b64 = self.raw_key.split("-", 1)[1]
+            payload_sig = base64.urlsafe_b64decode(b64 + "==")
+            payload_json, sig_hex = payload_sig.rsplit(b":", 1)
+            data = json.loads(payload_json)
+        except Exception as exc:
+            self.error = f"Malformed key: {exc}"
+            return
+
+        # Verify HMAC-SHA256 signature
+        expected_sig = hmac.new(
+            _LICENSE_SECRET.encode(),
+            payload_json,
+            hashlib.sha256,
+        ).hexdigest()[:24]
+
+        if not hmac.compare_digest(sig_hex.decode(), expected_sig):
+            self.error = "Invalid signature (tampered or wrong secret)"
+            return
+
+        self.tier = data.get("tier", LicenseTier.FREE)
+        self.expiry = data.get("exp", 0)
+        self.features = data.get("features", [])
+
+        if time.time() > self.expiry:
+            self.error = "License expired"
+            return
+
+        self.valid = True
+
+    # ── feature gates ───────────────────────────────────────────────────────
+
+    def can_use(self, feature: str) -> bool:
+        """Check if a feature is allowed by current tier."""
+        if self.tier == LicenseTier.ENTERPRISE:
+            return True
+        if self.tier == LicenseTier.PRO:
+            return feature not in {"sso", "audit_logs", "admin_dashboard"}
+        # FREE
+        free_features = {"chat", "tools_basic", "local_providers"}
+        return feature in free_features
+
+    def max_tool_calls(self) -> int:
+        if self.tier == LicenseTier.ENTERPRISE:
+            return 999_999
+        if self.tier == LicenseTier.PRO:
+            return 10_000
+        return 25  # FREE daily limit
+
+    def max_providers(self) -> int:
+        if self.tier in (LicenseTier.PRO, LicenseTier.ENTERPRISE):
+            return 99
+        return 2  # FREE: e.g. ollama + 1 cloud
+
+    def max_subagents(self) -> int:
+        if self.tier == LicenseTier.ENTERPRISE:
+            return 50
+        if self.tier == LicenseTier.PRO:
+            return 10
+        return 0  # FREE: no subagents
+
+    def max_plugins(self) -> int:
+        if self.tier == LicenseTier.ENTERPRISE:
+            return 999
+        if self.tier == LicenseTier.PRO:
+            return 50
+        return 3  # FREE
+
+    def allow_cloudsave(self) -> bool:
+        return self.tier in (LicenseTier.PRO, LicenseTier.ENTERPRISE)
+
+    def allow_voice(self) -> bool:
+        return self.tier in (LicenseTier.PRO, LicenseTier.ENTERPRISE)
+
+    def allow_telegram(self) -> bool:
+        return self.tier in (LicenseTier.PRO, LicenseTier.ENTERPRISE)
+
+    def allow_mcp(self) -> bool:
+        return self.tier in (LicenseTier.PRO, LicenseTier.ENTERPRISE)
+
+    # ── UI helpers ──────────────────────────────────────────────────────────
+
+    def status_banner(self) -> str:
+        if self.error:
+            return f"[LICENSE EXPIRED / INVALID] {self.error} — running in FREE mode"
+        if self.tier == LicenseTier.FREE:
+            return "[FREE] Limited features. Upgrade: https://getdulus.dev/pro"
+        return f"[{self.tier.upper()}] Valid until {time.strftime('%Y-%m-%d', time.localtime(self.expiry))}"
+
+
+# ── CLI helper for Kev ─────────────────────────────────────────────────────
+
+def _generate_key(tier: str, days: int, secret: str) -> str:
+    """Generate a signed license key (Kev-only tool)."""
+    payload = json.dumps({
+        "tier": tier,
+        "exp": int(time.time() + days * 86400),
+        "features": [],
+        "iat": int(time.time()),
+    }, separators=(",", ":")).encode()
+    sig = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()[:24]
+    token = base64.urlsafe_b64encode(payload + b":" + sig.encode()).decode().rstrip("=")
+    return f"DULUS-{token}"
+
+
+if __name__ == "__main__":
+    import argparse
+    ap = argparse.ArgumentParser(description="Dulus License Key Generator (Kev only)")
+    ap.add_argument("tier", choices=["free", "pro", "enterprise"])
+    ap.add_argument("--days", type=int, default=30)
+    ap.add_argument("--secret", default=_LICENSE_SECRET)
+    args = ap.parse_args()
+    print(_generate_key(args.tier, args.days, args.secret))

{dulus-0.2.40 → dulus-0.2.42}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dulus"
-version = "0.2.40"
+version = "0.2.42"
 description = "Spanish-first multi-provider AI CLI — 14 NVIDIA models free, Mesa Redonda, voice, TTS, RTK token reducer, MemPalace"
 readme = "README.md"
 requires-python = ">=3.11"

{dulus-0.2.40 → dulus-0.2.42}/task/store.py

@@ -61,15 +61,25 @@ def _next_id() -> str:
 def create_task(
     subject: str,
     description: str,
+    status: str = "pending",
+    owner: str = "",
     active_form: str = "",
     metadata: dict[str, Any] | None = None,
 ) -> Task:
     with _lock:
         _load()
+        # Validate status enum
+        try:
+            task_status = TaskStatus(status)
+        except ValueError:
+            task_status = TaskStatus.PENDING
+
         task = Task(
             id=_next_id(),
             subject=subject,
             description=description,
+            status=task_status,
+            owner=owner,
             active_form=active_form,
             metadata=metadata or {},
         )

{dulus-0.2.40 → dulus-0.2.42}/task/tools.py

@@ -26,6 +26,15 @@ _TASK_CREATE_SCHEMA = {
                 "type": "string",
                 "description": "What needs to be done",
             },
+            "status": {
+                "type": "string",
+                "enum": ["pending", "in_progress", "completed", "cancelled"],
+                "description": "Current state of the task (default is 'pending')",
+            },
+            "owner": {
+                "type": "string",
+                "description": "The agent or user responsible (e.g. 'A', 'B', 'User')",
+            },
             "active_form": {
                 "type": "string",
                 "description": (
@@ -38,7 +47,7 @@ _TASK_CREATE_SCHEMA = {
                 "description": "Arbitrary key-value metadata to attach to the task",
             },
         },
-        "required": ["subject", "description"],
+        "required": ["subject", "description", "status", "owner"],
     },
 }
 
@@ -128,9 +137,9 @@ _TASK_LIST_SCHEMA = {
 
 # ── Implementations ────────────────────────────────────────────────────────────
 
-def _task_create(subject: str, description: str, active_form: str = "", metadata: dict = None) -> str:
-    task = create_task(subject, description, active_form=active_form, metadata=metadata)
-    return f"Task #{task.id} created: {task.subject}"
+def _task_create(subject: str, description: str, status: str = "pending", owner: str = "", active_form: str = "", metadata: dict = None) -> str:
+    task = create_task(subject, description, status=status, owner=owner, active_form=active_form, metadata=metadata)
+    return f"Task #{task.id} created: {task.subject} (Owner: {task.owner}, Status: {task.status.value})"
 
 
 def _task_update(
@@ -220,8 +229,10 @@ def _register() -> None:
             func=lambda p, c: _task_create(
                 p["subject"],
                 p["description"],
-                p.get("active_form", ""),
-                p.get("metadata"),
+                status=p.get("status", "pending"),
+                owner=p.get("owner", ""),
+                active_form=p.get("active_form", ""),
+                metadata=p.get("metadata"),
             ),
             read_only=False,
             concurrent_safe=True,

{dulus-0.2.40 → dulus-0.2.42}/tools.py

@@ -59,7 +59,20 @@ def _is_in_tg_turn(config: dict) -> bool:
 
 # ── Tool JSON schemas (sent to Claude API) ─────────────────────────────────
 
+_LAUNCH_SANDBOX_SCHEMA = {
+    "name": "LaunchSandbox",
+    "description": "Start the Dulus Sandbox (mini-OS) web interface in the browser. "
+                   "Provides a visual desktop experience with integrated Dulus Terminal.",
+    "input_schema": {
+        "type": "object",
+        "properties": {
+            "stop": {"type": "boolean", "description": "If true, stop the server instead of starting it."}
+        },
+    },
+}
+
 TOOL_SCHEMAS = [
+    _LAUNCH_SANDBOX_SCHEMA,
     {
         "name": "Read",
         "description": (
@@ -2683,6 +2696,30 @@ register_tool(ToolDef(name="GitStatus", schema=_GIT_STATUS_SCHEMA, func=_git_sta
 register_tool(ToolDef(name="GitLog", schema=_GIT_LOG_SCHEMA, func=_git_log, read_only=True, concurrent_safe=True))
 
 
+def _launch_sandbox(params: dict, config: dict) -> str:
+    # Use the existing command handler from dulus.py
+    try:
+        from dulus import COMMANDS
+        handler = COMMANDS.get("sandbox")
+        if not handler:
+            return "Error: /sandbox command not found in Dulus."
+        
+        stop = params.get("stop", False)
+        args = "stop" if stop else ""
+        
+        state = config.get("_state")
+        if not state:
+            return "Error: Dulus session state not available to tool."
+            
+        handler(args, state, config)
+        return "Dulus Sandbox OS opened in browser." if not stop else "Sandbox stopped."
+    except Exception as e:
+        return f"Error launching sandbox: {e}"
+
+
+register_tool(ToolDef(name="LaunchSandbox", schema=_LAUNCH_SANDBOX_SCHEMA, func=_launch_sandbox))
+
+
 # Plugins are loaded once when Dulus starts (not on every reload to avoid overhead)
 try:
     from plugin.loader import register_plugin_tools
@@ -2700,3 +2737,5 @@ except Exception:
     # If plugin system fails, continue with core tools only
     _plugin_count = 0
 
+
+