tokenade 6.3.0__tar.gz → 6.4.0__tar.gz

{tokenade-6.3.0 → tokenade-6.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tokenade
-Version: 6.3.0
+Version: 6.4.0
 Summary: Production-grade token shifting and session portability tool
 Author: Tokenade Team
 License: MIT
@@ -49,17 +49,18 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: pytest-aiohttp>=1.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: pytest-timeout>=2.0.0; extra == "dev"
+Requires-Dist: pytest-xdist>=3.0.0; extra == "dev"
 Requires-Dist: hypothesis>=6.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: flake8>=6.0.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: build>=1.0.0; extra == "dev"
 
-# Tokenade v6.2 — Browser Session Portability Tool
+# Tokenade v6.4 — Browser Session Portability Tool
 
 Extract browser sessions from one device, package them into portable `.tokenade` files, and browse as the donor on another device using a **CDP reverse proxy** with TLS fingerprint matching.
 
-**5224+ tests** · **58 CLI commands** · **14 plugins** · **Grade A stealth**
+**5165+ tests** · **50 CLI commands** · **20 plugins** · **Grade A stealth**
 
 ## Features
 
@@ -646,18 +647,33 @@ so servers see the donor's fingerprint, not yours.
 | **Enterprise Features** | ✅ Audit, RBAC, LDAP | ❌ | ❌ |
 | **Self-Hosted** | ✅ No third-party | N/A | ✅ |
 
+## What's New in v6.4
+
+- **Plugin API v1.0** — All 20 plugins inherit from proper base classes (SessionRefreshPlugin, SiteHandlerPlugin, ProxyProviderPlugin, etc.)
+- **API_VERSION checking** — Plugins declare API version, loader validates at load time
+- **PluginResult** — Standard result type for all plugin methods
+- **PluginConfig** — Config with JSON schema validation
+- **Full Ecosystem Transfer** — .tokenade v3.0 format with per-origin localStorage + sessionStorage
+- **CDP StorageExtractor** — Extract localStorage/sessionStorage via Chrome DevTools Protocol
+- **Encryption at Export** — `--encrypt-password` flag encrypts .tokenade files at export time
+- **Plugin-First Export** — Auto-discovers site handler plugins for extraction
+- **ProxyProviderPlugin** — New base class for commercial proxy providers (AnyIP, BrightData, etc.)
+- **NotificationPlugin** — New base class for notification providers (Slack, Discord, Email)
+- **5165+ tests** — Comprehensive test coverage
+
+## What's New in v6.3
+
+- **Stealth modules consolidated** — `core/browser/stealth/` package (manager, launcher, cloak, backend)
+- **CLI handlers split** — `cli/handlers/` with infrastructure, CI, misc modules
+- **Test suite optimization** — pytest-xdist parallel execution (150s → 27s)
+
 ## What's New in v6.2
 
-- **CloakBrowser Integration** — Stealth Chromium binary with 58 C++ patches as default backend (Grade A stealth, 96/100)
+- **CloakBrowser Integration** — Stealth Chromium binary with 58 C++ patches as default backend
 - **Session CI Runner** — `tokenade ci run` reads `tokenade.yml` for automated session validation
 - **Fleet Management** — `tokenade fleet status|health|refresh|logs` across Docker/k8s containers
 - **Session Forensics** — `tokenade autopsy -s session.tokenade` — root-cause analysis for dead sessions
-- **Interactive TUI** — `tokenade tui` — marketplace browser, session manager, keyboard navigation (j/k/i/u/r)
-- **Site Handler Plugins** — Google, GitHub, Discord, Generic handlers for site-specific extraction/injection
-- **Global Ratings** — Sync plugin ratings via GitHub Issues API
-- **14 Official Plugins** — OAuth2, site handlers, session-health, webhook-notify, etc.
-- **58 CLI Commands** — Complete automation toolkit
-- **5224+ Tests** — Comprehensive test coverage
+- **Interactive TUI** — `tokenade tui` — marketplace browser, session manager, keyboard navigation
 
 ## What's New in v6.0
 
@@ -805,7 +821,7 @@ tokenade/
 │   └── base.py                     # Plugin base classes
 ├── handlers/                       # Site-specific handlers
 ├── extension/                      # Browser extension
-└── tests/                          # 5224+ tests
+└── tests/                          # 5165+ tests
 ```
 
 ## Security

{tokenade-6.3.0 → tokenade-6.4.0}/README.md

@@ -1,8 +1,8 @@
-# Tokenade v6.2 — Browser Session Portability Tool
+# Tokenade v6.4 — Browser Session Portability Tool
 
 Extract browser sessions from one device, package them into portable `.tokenade` files, and browse as the donor on another device using a **CDP reverse proxy** with TLS fingerprint matching.
 
-**5224+ tests** · **58 CLI commands** · **14 plugins** · **Grade A stealth**
+**5165+ tests** · **50 CLI commands** · **20 plugins** · **Grade A stealth**
 
 ## Features
 
@@ -589,18 +589,33 @@ so servers see the donor's fingerprint, not yours.
 | **Enterprise Features** | ✅ Audit, RBAC, LDAP | ❌ | ❌ |
 | **Self-Hosted** | ✅ No third-party | N/A | ✅ |
 
+## What's New in v6.4
+
+- **Plugin API v1.0** — All 20 plugins inherit from proper base classes (SessionRefreshPlugin, SiteHandlerPlugin, ProxyProviderPlugin, etc.)
+- **API_VERSION checking** — Plugins declare API version, loader validates at load time
+- **PluginResult** — Standard result type for all plugin methods
+- **PluginConfig** — Config with JSON schema validation
+- **Full Ecosystem Transfer** — .tokenade v3.0 format with per-origin localStorage + sessionStorage
+- **CDP StorageExtractor** — Extract localStorage/sessionStorage via Chrome DevTools Protocol
+- **Encryption at Export** — `--encrypt-password` flag encrypts .tokenade files at export time
+- **Plugin-First Export** — Auto-discovers site handler plugins for extraction
+- **ProxyProviderPlugin** — New base class for commercial proxy providers (AnyIP, BrightData, etc.)
+- **NotificationPlugin** — New base class for notification providers (Slack, Discord, Email)
+- **5165+ tests** — Comprehensive test coverage
+
+## What's New in v6.3
+
+- **Stealth modules consolidated** — `core/browser/stealth/` package (manager, launcher, cloak, backend)
+- **CLI handlers split** — `cli/handlers/` with infrastructure, CI, misc modules
+- **Test suite optimization** — pytest-xdist parallel execution (150s → 27s)
+
 ## What's New in v6.2
 
-- **CloakBrowser Integration** — Stealth Chromium binary with 58 C++ patches as default backend (Grade A stealth, 96/100)
+- **CloakBrowser Integration** — Stealth Chromium binary with 58 C++ patches as default backend
 - **Session CI Runner** — `tokenade ci run` reads `tokenade.yml` for automated session validation
 - **Fleet Management** — `tokenade fleet status|health|refresh|logs` across Docker/k8s containers
 - **Session Forensics** — `tokenade autopsy -s session.tokenade` — root-cause analysis for dead sessions
-- **Interactive TUI** — `tokenade tui` — marketplace browser, session manager, keyboard navigation (j/k/i/u/r)
-- **Site Handler Plugins** — Google, GitHub, Discord, Generic handlers for site-specific extraction/injection
-- **Global Ratings** — Sync plugin ratings via GitHub Issues API
-- **14 Official Plugins** — OAuth2, site handlers, session-health, webhook-notify, etc.
-- **58 CLI Commands** — Complete automation toolkit
-- **5224+ Tests** — Comprehensive test coverage
+- **Interactive TUI** — `tokenade tui` — marketplace browser, session manager, keyboard navigation
 
 ## What's New in v6.0
 
@@ -748,7 +763,7 @@ tokenade/
 │   └── base.py                     # Plugin base classes
 ├── handlers/                       # Site-specific handlers
 ├── extension/                      # Browser extension
-└── tests/                          # 5224+ tests
+└── tests/                          # 5165+ tests
 ```
 
 ## Security

{tokenade-6.3.0 → tokenade-6.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tokenade"
-version = "6.3.0"
+version = "6.4.0"
 description = "Production-grade token shifting and session portability tool"
 readme = "README.md"
 license = {text = "MIT"}
@@ -49,6 +49,7 @@ dev = [
     "pytest-aiohttp>=1.0.0",
     "pytest-cov>=4.0.0",
     "pytest-timeout>=2.0.0",
+    "pytest-xdist>=3.0.0",
     "hypothesis>=6.0.0",
     "black>=23.0.0",
     "flake8>=6.0.0",

{tokenade-6.3.0 → tokenade-6.4.0}/tokenade/__init__.py

@@ -18,7 +18,7 @@ Usage:
     main()
 """
 
-__version__ = "6.3.0"
+__version__ = "6.4.0"
 __author__ = "Tokenade Team"
 __license__ = "MIT"
 

{tokenade-6.3.0 → tokenade-6.4.0}/tokenade/cli/__init__.py

@@ -1026,6 +1026,12 @@ Commands:
     export_parser.add_argument("--decrypt", action="store_true", help="Decrypt cookies (auto-detected)")
     export_parser.add_argument("--extract-local-storage", action="store_true", help="Also extract localStorage data")
     export_parser.add_argument("--local-storage-origin", help="Origin to extract localStorage from")
+    export_parser.add_argument("--full", action="store_true", help="Extract cookies + localStorage + sessionStorage (v3.0 format)")
+    export_parser.add_argument("--no-storage", action="store_true", help="Extract only cookies (backward compat)")
+    export_parser.add_argument("--encrypt-password", help="Encrypt .tokenade file with this password at export time")
+    export_parser.add_argument("--plugin", help="Force specific site handler plugin (e.g., google-handler)")
+    export_parser.add_argument("--no-plugin", action="store_true", help="Skip plugin, use default extraction")
+    export_parser.add_argument("--list-handlers", action="store_true", help="List available site handler plugins")
 
     # Load
     load_parser = subparsers.add_parser("load", help="Load session file into browser")
@@ -1120,6 +1126,7 @@ Commands:
     proxy_parser.add_argument("--session", "-s", help="Path to .tokenade session file (single mode)")
     proxy_parser.add_argument("--all", action="store_true", help="Serve all sessions (multi-site mode)")
     proxy_parser.add_argument("--sessions-dir", "-d", help="Directory of .tokenade files (for --all)")
+    proxy_parser.add_argument("--decrypt-password", help="Decrypt .tokenade file with this password")
     proxy_parser.add_argument("--mode", choices=["gui", "forward"], default="gui",
                               help="Proxy mode: gui (browser GUI) or forward (HTTP_PROXY)")
     proxy_parser.add_argument("--port", "-p", type=int, default=9222, help="Port to listen on (default: 9222)")
@@ -1478,6 +1485,7 @@ Commands:
     launch_parser.add_argument("--geoip", action="store_true", help="Auto-detect timezone/locale from proxy IP (CloakBrowser)")
     launch_parser.add_argument("--no-cloak", action="store_true", help="Force Playwright + JS patches (skip CloakBrowser)")
     launch_parser.add_argument("--profile", help="Persistent profile directory (CloakBrowser)")
+    launch_parser.add_argument("--decrypt-password", help="Decrypt .tokenade file with this password")
 
     # Refresh Browser (cookie-based session refresh)
     refresh_browser_parser = subparsers.add_parser("refresh-browser", help="Refresh session via undetectable browser (no OAuth needed)")

{tokenade-6.3.0 → tokenade-6.4.0}/tokenade/cli/handlers/infrastructure.py

@@ -2,11 +2,7 @@
 Infrastructure CLI commands — fleet, container, k8s.
 """
 
-import json
 import logging
-import os
-import sys
-from pathlib import Path
 
 logger = logging.getLogger("tokenade")
 

tokenade-6.4.0/tokenade/cli/handlers/misc.py

@@ -0,0 +1,216 @@
+"""
+Misc CLI commands — tui, daemon, analytics, monitor.
+"""
+
+import json
+import logging
+from pathlib import Path
+
+logger = logging.getLogger("tokenade")
+
+
+def _health_bar(score: float, width: int = 20) -> str:
+    """Render a health score bar."""
+    filled = int(score / 100 * width)
+    bar = "█" * filled + "░" * (width - filled)
+    return f"[{bar}] {score:.0f}%"
+
+
+def cmd_monitor(args):
+    """Session monitoring management."""
+    from pathlib import Path
+
+    action = getattr(args, "monitor_command", None) or getattr(args, "monitor_action", None)
+
+    if action == "start":
+        _monitor_start(args)
+    elif action == "stop":
+        _monitor_stop()
+    elif action == "status":
+        _monitor_status(args)
+    elif action == "history":
+        _monitor_history()
+    elif action == "predict":
+        _monitor_predict(args)
+    else:
+        print("❌ Specify a monitor subcommand: status, start, stop, history, predict")
+
+
+def _monitor_start(args):
+    """Start background monitoring."""
+    import time
+    from tokenade.core.monitoring.session_monitor import SessionMonitor, MonitorConfig
+
+    session = getattr(args, "session", None)
+    sessions_dir = getattr(args, "sessions_dir", None)
+    interval = getattr(args, "interval", 60)
+
+    config = MonitorConfig(check_interval=interval)
+    monitor = SessionMonitor(config)
+
+    if session:
+        session_id = monitor.register_session_file(session)
+        if session_id:
+            print(f"✅ Monitoring session: {session_id}")
+        else:
+            print(f"❌ Failed to register: {session}")
+            return
+    elif sessions_dir:
+        config.sessions_dir = sessions_dir
+        monitor = SessionMonitor(config)
+        registered = monitor.scan_sessions_dir()
+        if registered:
+            print(f"✅ Monitoring {len(registered)} sessions")
+        else:
+            print(f"❌ No sessions found in {sessions_dir}")
+            return
+    else:
+        print("❌ Specify --session or --sessions-dir")
+        return
+
+    monitor.start()
+    print("✅ Monitor started (Ctrl+C to stop)")
+    try:
+        while True:
+            time.sleep(interval)
+    except KeyboardInterrupt:
+        monitor.stop()
+        print("\n✅ Monitor stopped")
+
+
+def _monitor_stop():
+    """Stop a running monitor (by PID file)."""
+    import os
+    import signal
+    pid_file = Path("~/.tokenade/monitor.pid").expanduser()
+    if not pid_file.exists():
+        print("❌ No monitor process found (no PID file)")
+        return
+
+    try:
+        pid = int(pid_file.read_text().strip())
+        os.kill(pid, signal.SIGTERM)
+        print(f"✅ Sent stop signal to monitor (PID: {pid})")
+        pid_file.unlink(missing_ok=True)
+    except (ProcessLookupError, ValueError) as e:
+        print(f"❌ Failed to stop monitor: {e}")
+        pid_file.unlink(missing_ok=True)
+
+
+def _monitor_status(args):
+    """Show current monitoring status."""
+    from tokenade.core.monitoring.session_monitor import SessionMonitor, MonitorConfig
+
+    session = getattr(args, "session", None)
+    sessions_dir = getattr(args, "sessions_dir", None)
+
+    print("\n" + "=" * 60)
+    print("TOKENADE - Session Monitor Status")
+    print("=" * 60)
+
+    config = MonitorConfig(sessions_dir=sessions_dir)
+    monitor = SessionMonitor(config)
+
+    if session:
+        # Register the session if not already monitored
+        session_id = monitor.register_session_file(session)
+        if session_id:
+            status = monitor.get_status(session_id)
+        else:
+            status = None
+        if status:
+            site = status.site_name or session_id
+            bar = _health_bar(status.health_score)
+            print(f"\n📊 {site}")
+            print(f"   Health: {bar}")
+            print(f"   Cookies: {status.cookie_count}")
+            print(f"   Expired: {status.expired_cookies}")
+        else:
+            print(f"❌ No status for: {session}")
+    elif sessions_dir:
+        registered = monitor.scan_sessions_dir()
+        if not registered:
+            print(f"📂 No sessions found in {sessions_dir}")
+        else:
+            statuses = monitor.get_all_statuses()
+            print(f"\n📂 {len(statuses)} sessions in {sessions_dir}\n")
+            for s in statuses:
+                bar = _health_bar(s.health_score)
+                print(f"  {s.session_id}: {bar}")
+    else:
+        statuses = monitor.get_all_statuses()
+        if not statuses:
+            print("❌ No sessions registered. Use --session or --sessions-dir")
+        else:
+            print(f"\n📊 {len(statuses)} monitored sessions\n")
+            for s in statuses:
+                bar = _health_bar(s.health_score)
+                print(f"  {s.session_id}: {bar}")
+
+
+def _monitor_history():
+    """Show monitor event history."""
+    from tokenade.core.monitoring.session_monitor import SessionMonitor
+
+    monitor = SessionMonitor()
+    history = monitor.get_event_history()
+    if not history:
+        print("No monitor events recorded yet")
+        return
+    print(f"\n📋 Last {min(10, len(history))} events:\n")
+    for event in history[-10:]:
+        print(f"  {event}")
+
+
+def _monitor_predict(args):
+    """Predict session expiry."""
+    from tokenade.core.monitoring.session_monitor import SessionMonitor
+
+    session = getattr(args, "session", None)
+    monitor = SessionMonitor()
+
+    if session:
+        status = monitor.get_status(session)
+        if status and status.predicted_expiry:
+            print(f"⏰ {session}: predicted expiry in {status.predicted_expiry}")
+        else:
+            print("insufficient data for prediction")
+    else:
+        print("insufficient data for prediction")
+
+
+def cmd_analytics(args):
+    """Session usage analytics."""
+    from tokenade.core.monitoring.analytics import SessionAnalytics
+
+    analytics = SessionAnalytics()
+
+    if args.analytics_command == "report":
+        days = getattr(args, "days", 30)
+        report = analytics.get_usage_report(days=days)
+        print(json.dumps(report, indent=2))
+    elif args.analytics_command == "cleanup":
+        analytics.cleanup()
+        print("✅ Analytics data cleaned up")
+    else:
+        print("Usage: tokenade analytics {report|cleanup}")
+        print("Usage: tokenade analytics {report|cleanup}")
+
+
+def cmd_daemon(args):
+    """Background daemon management."""
+    from tokenade.core.daemon.session_daemon import SessionDaemon
+
+    daemon = SessionDaemon()
+
+    if args.daemon_action == "start":
+        daemon.start()
+        print("✅ Daemon started")
+    elif args.daemon_action == "stop":
+        daemon.stop()
+        print("✅ Daemon stopped")
+    elif args.daemon_action == "status":
+        status = daemon.get_status()
+        print(f"Daemon status: {status}")
+    else:
+        print("Usage: tokenade daemon {start|stop|status}")