qbraid-lex 0.1.0__py3-none-any.whl

qbraid_lab/BUILD_MANIFEST.json

@@ -0,0 +1,25 @@
+{
+  "version": "0.1.0",
+  "build_type": "production",
+  "timestamp": "2026-05-30T18:09:38Z",
+  "git": {
+    "branch": "main",
+    "commit": "262db95",
+    "dirty": true,
+    "repo": "qBraid/qbraid-lab-extensions"
+  },
+  "vendor": {
+    "qbraid_core": "not bundled",
+    "qbraid_cli": "not bundled"
+  },
+  "jupyterlab": "4.5.7",
+  "features": {
+    "environments": "262db95 chore(jobs): use typed delete_group from qbraid-core (>=0.3.3) (#99)",
+    "devices": "262db95 chore(jobs): use typed delete_group from qbraid-core (>=0.3.3) (#99)",
+    "jobs": "262db95 chore(jobs): use typed delete_group from qbraid-core (>=0.3.3) (#99)",
+    "dashboard": "262db95 chore(jobs): use typed delete_group from qbraid-core (>=0.3.3) (#99)",
+    "vault": "262db95 chore(jobs): use typed delete_group from qbraid-core (>=0.3.3) (#99)",
+    "walkthrough": "262db95 chore(jobs): use typed delete_group from qbraid-core (>=0.3.3) (#99)",
+    "sync": "262db95 chore(jobs): use typed delete_group from qbraid-core (>=0.3.3) (#99)"
+  }
+}

qbraid_lab/__init__.py

@@ -0,0 +1,91 @@
+"""qBraid Lab - Unified JupyterLab extension for qBraid."""
+
+import os
+
+from ._version import __version__
+from .handlers import setup_handlers  # Now imports from handlers/ package
+
+__all__ = ["__version__"]
+
+
+def _jupyter_labextension_paths():
+    """Return the paths to the JupyterLab extension."""
+    return [{"src": "labextension", "dest": "@qbraid/lab"}]
+
+
+def _jupyter_server_extension_points():
+    """Return the server extension points."""
+    return [{"module": "qbraid_lab"}]
+
+
+def _load_jupyter_server_extension(server_app):
+    """Load the Jupyter server extension.
+
+    Sets up handlers, installs agent CLI hooks, prunes dead sessions,
+    and writes server connection info for hook callbacks.
+    """
+    setup_handlers(server_app.web_app)
+
+    # Install agent hooks and initialise registry (non-blocking)
+    try:
+        from qbraid_core.services.agents import install_all_hooks
+        from qbraid_core.services.agents.registry import AgentSessionRegistryManager
+
+        registry = AgentSessionRegistryManager()
+        registry.prune_dead_sessions()
+
+        try:
+            install_all_hooks()
+        except Exception as e:
+            import logging
+            logging.getLogger(__name__).debug("Hook installation skipped: %s", e)
+
+        def _write_server_info_deferred():
+            port = getattr(server_app, "port", 8888)
+            token = ""
+            try:
+                token = server_app.identity_provider.token or ""
+            except AttributeError:
+                pass
+            AgentSessionRegistryManager.write_server_info(port, os.getpid(), token)
+
+        from tornado.ioloop import IOLoop
+        IOLoop.current().call_later(1, _write_server_info_deferred)
+
+    except ImportError:
+        import logging
+        logging.getLogger(__name__).debug("qbraid-core agents module not available, skipping hook setup")
+    except Exception as e:
+        import logging
+        logging.getLogger(__name__).warning("Agent service init error (non-fatal): %s", e)
+
+    # Inject analytics config into PageConfig so the frontend can read it
+    # without hardcoding keys in the client bundle
+    events_url = os.environ.get("QBRAID_EVENTS_URL", "")
+    events_key = os.environ.get("QBRAID_EVENTS_KEY", "")
+    if events_url and events_key:
+        server_app.web_app.settings.setdefault("page_config_data", {})
+        server_app.web_app.settings["page_config_data"]["qbraidEventsUrl"] = events_url
+        server_app.web_app.settings["page_config_data"]["qbraidEventsKey"] = events_key
+        server_app.log.info("qbraid_lab: analytics events endpoint configured")
+
+    # Auto-trigger file sync on cloud pods.
+    # Schedule on the next IOLoop tick (not call_later(2, ...)) — a 2s delay
+    # lets the frontend's SSE stream connect first, see _sync_task=None and
+    # an empty manifest, emit "done", and render the idle UI before the
+    # sync ever starts. By scheduling immediately we ensure _sync_task is
+    # populated by the time the frontend serves its first SSE request.
+    if os.environ.get("QBRAID_CLOUD"):
+        try:
+            from tornado.ioloop import IOLoop
+            from .handlers.file_sync import _start_sync
+
+            def _auto_sync():
+                _start_sync()
+                server_app.log.info("qbraid_lab: auto-triggered file sync (cloud mode)")
+
+            IOLoop.current().add_callback(_auto_sync)
+        except ImportError:
+            server_app.log.debug("qbraid_lab: file sync module not available, skipping auto-sync")
+
+    server_app.log.info("qbraid_lab server extension loaded")

qbraid_lab/_version.py

@@ -0,0 +1,4 @@
+# This file is auto-generated by Hatchling. As such, do not:
+#   - modify
+#   - track in version control e.g. be sure to add to .gitignore
+__version__ = VERSION = '0.1.0'

qbraid_lab/handlers/__init__.py

@@ -0,0 +1,399 @@
+"""Handlers for qBraid Lab server extension.
+
+This module consolidates all server handlers:
+- Auth: qbraid-config, qiskit-config, server-ready, validate-config, disk-usage
+- Devices: list devices, get device by QRN
+- Jobs: list/create/delete jobs, get job details, results, program, cancel
+- Environments: install, list, manage environments (from lab-environment-manager)
+"""
+
+import logging
+
+from jupyter_server.utils import url_path_join
+
+from .auth import (
+    DiskUsageHandler,
+    PythonInfoHandler,
+    QiskitConfigHandler,
+    ServerReadyHandler,
+    UserConfigHandler,
+    UserIdentityHandler,
+    UserVerifyHandler,
+    UserContextHandler,
+    OnboardingProfileHandler,
+    ValidateConfigHandler,
+)
+from .ibm_proxy import IBMProxyHandler
+from .devices import DeviceHandler, DevicesHandler, ProvidersHandler
+from .jobs import (
+    JobCancelHandler,
+    JobHandler,
+    JobProgramHandler,
+    JobProgramAsciiHandler,
+    JobResultHandler,
+    JobsHandler,
+    JobStatusesHandler,
+)
+from .group_jobs import (
+    GroupJobsListHandler,
+    GroupJobHandler,
+    GroupJobChildrenHandler,
+    GroupJobCancelHandler,
+)
+from .credits import CreditsHandler
+from .environments.handlers import setup_handlers as setup_environment_handlers
+from .dashboard import (
+    DashboardSessionsHandler, SessionKillHandler, SessionRenameHandler,
+    SessionRegisterHandler, SessionDeregisterHandler, SessionDiscoverHandler, SessionDiscoverAllHandler,
+    DirectoryBrowseHandler, TranscriptStreamHandler, TerminalInputHandler,
+    OpenCodeSessionsHandler, OpenCodeStatusHandler,
+    OpenCodeEventStreamHandler, CodexTranscriptStreamHandler,
+    ClaudeSessionBrowserHandler,
+)
+from .dashboard_agents import (
+    AgentLaunchHandler, AgentResumeHandler, AgentSendHandler,
+    AgentReadHandler, AgentSearchHandler, AgentUpdateHandler,
+    PermissionApproveHandler, PermissionDenyHandler,
+    PermissionPendingHandler, PermissionWatchHandler,
+    MessageSendHandler, MessageInboxHandler, MessageMarkReadHandler,
+    RemoteLaunchHandler, RemoteListHandler, RemoteSendHandler,
+    RemoteReadHandler, ComputeServersHandler,
+    GitHubReposHandler,
+)
+from .dashboard_ws import DashboardWebSocketHandler, _install_notify_hook
+from .projects import ProjectListHandler, ProjectBoardHandler
+from .hub_projects import (
+    GetProjectStreamHandler,
+    HubProjectDetailHandler,
+    HubProjectsListHandler,
+)
+from .file_sync import FileSyncStreamHandler, FileSyncTriggerHandler
+from .vault import VaultHandler
+from .ssh import SSHKeyHandler
+from .connected_accounts import (
+    CLICheckHandler,
+    CLISubmitCodeHandler,
+    ClaudeInitiateHandler,
+    CodexInitiateHandler,
+    ConnectedAccountsStatusHandler,
+    DisconnectHandler,
+    GitHubDeviceCodeHandler,
+    GitHubPollHandler,
+    SlackInitiateHandler,
+)
+from .slack_callback import SlackCallbackHandler
+from .settings import SettingsHandler
+from .tours import ToursHandler, TourHandler
+from .published_tours import PublishedToursHandler, PublishedTourHandler
+from .slack_notify import SlackNotifyHandler
+from .slack_inbox import SlackInboxHandler
+from .compute import ComputeUsageHandler, ComputeSessionHandler, ComputeShutdownHandler
+from .cloud_jobs import CloudJobsIBMHandler, CloudJobsIBMTaskHandler, CloudJobsIBMBackendsHandler, CloudJobsAWSHandler, CloudJobsAWSTaskHandler, InstallProviderHandler
+from .version import VersionHandler
+from .system_metrics import SystemMetricsHandler
+from .notebook_fetch import FetchNotebookHandler
+from .package_check import CheckPackagesHandler
+
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
+
+__all__ = [
+    # Auth handlers
+    "UserConfigHandler",
+    "QiskitConfigHandler",
+    "ServerReadyHandler",
+    "ValidateConfigHandler",
+    "DiskUsageHandler",
+    "PythonInfoHandler",
+    # Device handlers
+    "DevicesHandler",
+    "DeviceHandler",
+    "ProvidersHandler",
+    # Job handlers
+    "JobsHandler",
+    "JobStatusesHandler",
+    "JobHandler",
+    "JobResultHandler",
+    "JobProgramHandler",
+    "JobCancelHandler",
+    # Group job handlers
+    "GroupJobsListHandler",
+    "GroupJobHandler",
+    "GroupJobChildrenHandler",
+    "GroupJobCancelHandler",
+    # Credits handler
+    "CreditsHandler",
+    # Proxy handlers
+    "IBMProxyHandler",
+    "UserVerifyHandler",
+    "UserIdentityHandler",
+    "UserContextHandler",
+    "OnboardingProfileHandler",
+    # Environment handlers (submodule)
+    "setup_environment_handlers",
+    # File sync handlers
+    "FileSyncStreamHandler",
+    "FileSyncTriggerHandler",
+    # Dashboard handlers
+    "DashboardWebSocketHandler",
+    "DashboardSessionsHandler",
+    "SessionRegisterHandler",
+    "SessionDeregisterHandler",
+    "SessionDiscoverHandler",
+    "SessionDiscoverAllHandler",
+    "SessionKillHandler",
+    "SessionRenameHandler",
+    "DirectoryBrowseHandler",
+    # Agent handlers
+    "AgentLaunchHandler",
+    "AgentResumeHandler",
+    "AgentSendHandler",
+    "AgentReadHandler",
+    "AgentSearchHandler",
+    "AgentUpdateHandler",
+    "PermissionApproveHandler",
+    "PermissionDenyHandler",
+    "PermissionPendingHandler",
+    "PermissionWatchHandler",
+    "MessageSendHandler",
+    "MessageInboxHandler",
+    "MessageMarkReadHandler",
+    "RemoteLaunchHandler",
+    "RemoteListHandler",
+    "RemoteSendHandler",
+    "RemoteReadHandler",
+    "ComputeServersHandler",
+    "GitHubReposHandler",
+    # Vault handler
+    "VaultHandler",
+    # SSH key handler
+    "SSHKeyHandler",
+    # Connected accounts handlers
+    "ConnectedAccountsStatusHandler",
+    "GitHubDeviceCodeHandler",
+    "GitHubPollHandler",
+    "ClaudeInitiateHandler",
+    "CodexInitiateHandler",
+    "CLICheckHandler",
+    "CLISubmitCodeHandler",
+    "DisconnectHandler",
+    "SlackInitiateHandler",
+    # Slack callback handler
+    "SlackCallbackHandler",
+    # Notification handlers
+    "SlackNotifyHandler",
+    # Settings handler
+    "SettingsHandler",
+    # Tours handlers
+    "ToursHandler",
+    "TourHandler",
+    # Compute handler
+    "ComputeUsageHandler",
+    # Setup function
+    "setup_handlers",
+]
+
+
+def setup_handlers(web_app):
+    """Setup the server extension handlers."""
+    host_pattern = ".*$"
+    base_url = web_app.settings["base_url"]
+
+    # Auth routes (compatible with lab-authentication-server paths)
+    auth_prefix = "qbraid-authentication-server"
+    auth_handlers = [
+        (url_path_join(base_url, auth_prefix, "qbraid-config"), UserConfigHandler),
+        (url_path_join(base_url, auth_prefix, "qiskit-config"), QiskitConfigHandler),
+        (url_path_join(base_url, auth_prefix, "server-ready"), ServerReadyHandler),
+        (url_path_join(base_url, auth_prefix, "validate-config"), ValidateConfigHandler),
+        (url_path_join(base_url, auth_prefix, "qbraid-disk-usage"), DiskUsageHandler),
+        (url_path_join(base_url, auth_prefix, "python-info"), PythonInfoHandler),
+    ]
+
+    # Devices routes
+    # Note: QRN contains colons (e.g., "ibm:ibm:qpu:marrakesh"), use regex to capture
+    devices_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "devices"), DevicesHandler),
+        (url_path_join(base_url, "qbraid-lab", r"devices/(.+)"), DeviceHandler),
+        (url_path_join(base_url, "qbraid-lab", "providers"), ProvidersHandler),
+    ]
+
+    # Jobs routes
+    # Jobs QRN also contains colons
+    # Group routes MUST come before the catch-all jobs/([^/]+) to avoid route conflicts
+    jobs_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "jobs"), JobsHandler),
+        (url_path_join(base_url, "qbraid-lab", "jobs", "statuses"), JobStatusesHandler),
+        (url_path_join(base_url, "qbraid-lab", "jobs", "group"), GroupJobsListHandler),
+        (url_path_join(base_url, "qbraid-lab", r"jobs/group/([^/]+)/jobs"), GroupJobChildrenHandler),
+        (url_path_join(base_url, "qbraid-lab", r"jobs/group/([^/]+)/cancel"), GroupJobCancelHandler),
+        (url_path_join(base_url, "qbraid-lab", r"jobs/group/([^/]+)"), GroupJobHandler),
+        (url_path_join(base_url, "qbraid-lab", r"jobs/([^/]+)/result"), JobResultHandler),
+        (url_path_join(base_url, "qbraid-lab", r"jobs/([^/]+)/program"), JobProgramHandler),
+        (url_path_join(base_url, "qbraid-lab", r"jobs/([^/]+)/program/ascii"), JobProgramAsciiHandler),
+        (url_path_join(base_url, "qbraid-lab", r"jobs/([^/]+)/cancel"), JobCancelHandler),
+        (url_path_join(base_url, "qbraid-lab", r"jobs/(?!group(?:/|$))([^/]+)"), JobHandler),
+    ]
+
+    credits_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "credits"), CreditsHandler),
+    ]
+
+    # File sync routes (SSE stream + manual trigger)
+    sync_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "sync-stream"), FileSyncStreamHandler),
+        (url_path_join(base_url, "qbraid-lab", "sync-trigger"), FileSyncTriggerHandler),
+    ]
+
+    # Proxy handlers (route external API calls through server)
+    proxy_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "ibm-proxy"), IBMProxyHandler),
+        (url_path_join(base_url, "qbraid-lab", "users", "verify"), UserVerifyHandler),
+        (url_path_join(base_url, "qbraid-lab", "users", "context"), UserContextHandler),
+        (url_path_join(base_url, "qbraid-lab", "users", "onboarding-profile"), OnboardingProfileHandler),
+        (url_path_join(base_url, "qbraid-lab", "identity"), UserIdentityHandler),
+    ]
+
+    # Dashboard routes
+    dashboard_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "ws"), DashboardWebSocketHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "sessions"), DashboardSessionsHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "sessions", "register"), SessionRegisterHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "sessions", "deregister"), SessionDeregisterHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "sessions", "discover"), SessionDiscoverHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "sessions", "discover-all"), SessionDiscoverAllHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "sessions", "kill"), SessionKillHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "sessions", "rename"), SessionRenameHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "browse"), DirectoryBrowseHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "transcript", "stream"), TranscriptStreamHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "terminal", "input"), TerminalInputHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "opencode", "sessions"), OpenCodeSessionsHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "opencode", "status"), OpenCodeStatusHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "opencode", "events"), OpenCodeEventStreamHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "codex", "stream"), CodexTranscriptStreamHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "claude", "sessions"), ClaudeSessionBrowserHandler),
+    ]
+
+    # Agent lifecycle, permissions, messaging, GitHub
+    agent_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "launch"), AgentLaunchHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "resume"), AgentResumeHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "send"), AgentSendHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "read"), AgentReadHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "search"), AgentSearchHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "update"), AgentUpdateHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "approve"), PermissionApproveHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "deny"), PermissionDenyHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "permissions"), PermissionPendingHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "permissions", "watch"), PermissionWatchHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "messages", "send"), MessageSendHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "messages", "inbox"), MessageInboxHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "messages", "mark-read"), MessageMarkReadHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "remote", "launch"), RemoteLaunchHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "remote", "list"), RemoteListHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "remote", "send"), RemoteSendHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "remote", "read"), RemoteReadHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "agents", "remote", "servers"), ComputeServersHandler),
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "github", "repos"), GitHubReposHandler),
+        # Project boards
+        (url_path_join(base_url, "qbraid-lab", "dashboard", "projects"), ProjectListHandler),
+        (url_path_join(base_url, "qbraid-lab", r"dashboard/projects/([^/]+)"), ProjectBoardHandler),
+    ]
+
+    # Vault route
+    vault_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "vault"), VaultHandler),
+    ]
+
+    # SSH key route
+    ssh_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "ssh-keys"), SSHKeyHandler),
+    ]
+
+    # Connected accounts routes
+    ca_prefix = url_path_join(base_url, "qbraid-lab", "connected-accounts")
+    connected_accounts_handlers = [
+        (url_path_join(ca_prefix, "status"), ConnectedAccountsStatusHandler),
+        (url_path_join(ca_prefix, "github", "device-code"), GitHubDeviceCodeHandler),
+        (url_path_join(ca_prefix, "github", "poll"), GitHubPollHandler),
+        (url_path_join(ca_prefix, "claude", "initiate"), ClaudeInitiateHandler),
+        (url_path_join(ca_prefix, "codex", "initiate"), CodexInitiateHandler),
+        (url_path_join(ca_prefix, "slack", "initiate"), SlackInitiateHandler),
+        (url_path_join(ca_prefix, "cli-submit-code"), CLISubmitCodeHandler),
+        (url_path_join(ca_prefix, "cli-check"), CLICheckHandler),
+        (url_path_join(ca_prefix, "disconnect"), DisconnectHandler),
+    ]
+
+    # Slack OAuth callback (unauthenticated — Slack redirects browser here)
+    slack_callback_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "slack-callback"), SlackCallbackHandler),
+    ]
+
+    # Notification routes
+    notification_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "notifications", "slack"), SlackNotifyHandler),
+        (url_path_join(base_url, "qbraid-lab", "slack-message"), SlackInboxHandler),
+    ]
+
+    # Settings route
+    settings_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "settings"), SettingsHandler),
+        (url_path_join(base_url, "qbraid-lab", "version"), VersionHandler),
+        (url_path_join(base_url, "qbraid-lab", "check-packages"), CheckPackagesHandler),
+    ]
+
+    # Compute usage route
+    compute_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "compute", "usage"), ComputeUsageHandler),
+        (url_path_join(base_url, "qbraid-lab", "compute", "session"), ComputeSessionHandler),
+        (url_path_join(base_url, "qbraid-lab", "compute", "shutdown"), ComputeShutdownHandler),
+    ]
+
+    # Tours routes (local)
+    tours_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "tours"), ToursHandler),
+        (url_path_join(base_url, "qbraid-lab", r"tours/([^/]+)"), TourHandler),
+    ]
+
+    # Published tours routes (cloud API proxy)
+    published_tours_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "published-tours"), PublishedToursHandler),
+        (url_path_join(base_url, "qbraid-lab", r"published-tours/([^/]+)"), PublishedTourHandler),
+    ]
+
+    # Cloud provider direct job access
+    cloud_jobs_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "cloud-jobs", "ibm"), CloudJobsIBMHandler),
+        (url_path_join(base_url, "qbraid-lab", "cloud-jobs", "ibm", "task"), CloudJobsIBMTaskHandler),
+        (url_path_join(base_url, "qbraid-lab", "cloud-jobs", "ibm", "backends"), CloudJobsIBMBackendsHandler),
+        (url_path_join(base_url, "qbraid-lab", "cloud-jobs", "aws"), CloudJobsAWSHandler),
+        (url_path_join(base_url, "qbraid-lab", "cloud-jobs", "aws", "task"), CloudJobsAWSTaskHandler),
+        (url_path_join(base_url, "qbraid-lab", "cloud-jobs", "install"), InstallProviderHandler),
+    ]
+
+    # Hub projects (Explore feature): list/detail + SSE install stream
+    hub_projects_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "hub-projects"), HubProjectsListHandler),
+        (url_path_join(base_url, "qbraid-lab", r"hub-projects/([^/]+)"), HubProjectDetailHandler),
+        (url_path_join(base_url, "qbraid-lab", r"get-project/([^/]+)"), GetProjectStreamHandler),
+    ]
+
+    # Fetch individual notebooks from GitHub repos
+    notebook_fetch_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "fetch-notebook"), FetchNotebookHandler),
+    ]
+
+    # System metrics (for analytics / mining detection)
+    metrics_handlers = [
+        (url_path_join(base_url, "qbraid-lab", "system-metrics"), SystemMetricsHandler),
+    ]
+
+    all_handlers = auth_handlers + devices_handlers + jobs_handlers + credits_handlers + sync_handlers + proxy_handlers + dashboard_handlers + agent_handlers + vault_handlers + ssh_handlers + connected_accounts_handlers + slack_callback_handlers + notification_handlers + settings_handlers + compute_handlers + tours_handlers + published_tours_handlers + cloud_jobs_handlers + hub_projects_handlers + notebook_fetch_handlers + metrics_handlers
+
+    web_app.add_handlers(host_pattern, all_handlers)
+
+    # Wire up WebSocket push notifications for dashboard registry changes
+    _install_notify_hook()
+
+    # Environment handlers (from lab-environment-manager)
+    # These use a separate setup function with url_path prefix
+    setup_environment_handlers(web_app, "jupyter-environment-manager")