synapse-sdk 1.0.0a61__tar.gz → 1.0.0a63__tar.gz

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-sdk
-Version: 1.0.0a61
+Version: 1.0.0a63
 Summary: synapse sdk
 Author-email: datamaker <developer@datamaker.io>
 License: MIT

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk/cli/__init__.py

@@ -106,18 +106,36 @@ def display_connection_status():
     click.echo()  # Empty line for spacing
 
 
-def run_devtools(build=False):
+def run_devtools(build=True):
     """Run devtools with default settings"""
     try:
+        from synapse_sdk.devtools.config import get_server_config
         from synapse_sdk.devtools.server import create_devtools_server
+        from synapse_sdk.devtools.utils import find_available_port, is_port_available
 
         if build:
-            click.echo('Building frontend assets...')
+            click.echo('Building...')
             build_frontend()
 
         click.echo('Starting Synapse Devtools...')
-        server = create_devtools_server(host='0.0.0.0', port=8080)
-        server.start_server(open_browser=True)
+
+        # Get server configuration defaults
+        server_config = get_server_config()
+        host = server_config['host']
+        port = server_config['port']
+
+        # Check if the port is available, fallback to next available port if not
+        if not is_port_available(host, port):
+            try:
+                fallback_port = find_available_port(host, port + 1)
+                click.echo(click.style(f'Port {port} is in use, falling back to port {fallback_port}', fg='yellow'))
+                port = fallback_port
+            except RuntimeError as e:
+                click.echo(click.style(f'Failed to find available port: {e}', fg='red'), err=True)
+                return
+
+        server = create_devtools_server(host=host, port=port)
+        server.start_server()
     except ImportError:
         click.echo(
             click.style(
@@ -153,21 +171,20 @@ def build_frontend():
     try:
         # Install dependencies if node_modules doesn't exist
         if not (devtools_dir / 'node_modules').exists():
-            click.echo('Installing frontend dependencies...')
+            click.echo('Installing dependencies...')
             result = subprocess.run(['npm', 'install'], cwd=devtools_dir, capture_output=True, text=True)
             if result.returncode != 0:
                 click.echo(click.style(f'npm install failed:\n{result.stderr}', fg='red'), err=True)
                 return False
 
         # Build the frontend
-        click.echo('Building frontend...')
         result = subprocess.run(['npm', 'run', 'build'], cwd=devtools_dir, capture_output=True, text=True)
 
         if result.returncode != 0:
             click.echo(click.style(f'Frontend build failed:\n{result.stderr}', fg='red'), err=True)
             return False
 
-        click.echo(click.style('Frontend build completed successfully!', fg='green'))
+        click.echo(click.style('Build completed successfully!', fg='green'))
         return True
 
     except Exception as e:
@@ -184,23 +201,13 @@ def run_config():
 
 @click.group(invoke_without_command=True)
 @click.option('--dev-tools', is_flag=True, help='Start devtools immediately')
-@click.option('--build', is_flag=True, help='Build frontend before starting devtools (only with --dev-tools)')
 @click.pass_context
-def cli(ctx, dev_tools, build):
+def cli(ctx, dev_tools):
     """Synapse SDK - Interactive CLI"""
 
     # Handle --dev-tools flag
     if dev_tools:
-        if build:
-            run_devtools(build=True)
-        else:
-            run_devtools(build=False)
-        return
-
-    # Handle --build flag without --dev-tools (show warning)
-    if build and not dev_tools:
-        click.echo(click.style('Warning: --build flag requires --dev-tools flag', fg='yellow'))
-        click.echo('Use: synapse --dev-tools --build')
+        run_devtools()
         return
 
     if ctx.invoked_subcommand is None:

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk/cli/devtools.py

@@ -9,15 +9,15 @@ from synapse_sdk.i18n import gettext as _
 @click.command()
 @click.option('--host', default=None, help='Host to bind the devtools server')
 @click.option('--port', default=None, type=int, help='Port to bind the devtools server')
-@click.option('--no-browser', is_flag=True, help='Do not open browser automatically')
 @click.option('--debug', is_flag=True, help='Run in debug mode')
-@click.option('--build', is_flag=True, help='Build frontend assets before starting server')
-def devtools(host, port, no_browser, debug, build):
+def devtools(host, port, debug):
     """Start the Synapse devtools web interface"""
 
     try:
         from synapse_sdk.devtools.config import get_server_config
         from synapse_sdk.devtools.server import create_devtools_server
+        from synapse_sdk.devtools.utils import find_available_port, is_port_available
+
     except ImportError:
         click.echo(
             click.style(
@@ -27,12 +27,11 @@ def devtools(host, port, no_browser, debug, build):
         )
         sys.exit(1)
 
-    if build:
-        click.echo('Building frontend assets...')
-        from synapse_sdk.cli import build_frontend
+    click.echo('Building assets...')
+    from synapse_sdk.cli import build_frontend
 
-        if not build_frontend():
-            click.echo(click.style('Build failed, continuing with existing assets...', fg='yellow'))
+    if not build_frontend():
+        click.echo(click.style('Build failed, continuing with existing assets...', fg='yellow'))
 
     if debug:
         click.echo(_('Starting devtools in debug mode...'))
@@ -47,13 +46,23 @@ def devtools(host, port, no_browser, debug, build):
     final_host = host if host is not None else server_config['host']
     final_port = port if port is not None else server_config['port']
 
+    # Check if the port is available, fallback to next available port if not
+    if not is_port_available(final_host, final_port):
+        try:
+            fallback_port = find_available_port(final_host, final_port + 1)
+            click.echo(click.style(f'Port {final_port} is in use, falling back to port {fallback_port}', fg='yellow'))
+            final_port = fallback_port
+        except RuntimeError as e:
+            click.echo(click.style(f'Failed to find available port: {e}', fg='red'), err=True)
+            sys.exit(1)
+
     # Create and start the devtools server
     # Pass the current working directory as the plugin directory
     plugin_directory = os.getcwd()
     server = create_devtools_server(host=final_host, port=final_port, plugin_directory=plugin_directory)
 
     try:
-        server.start_server(open_browser=not no_browser)
+        server.start_server()
     except KeyboardInterrupt:
         click.echo(_('\nDevtools stopped.'))
     except Exception as e:

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk/cli/plugin/publish.py

@@ -8,14 +8,14 @@ from synapse_sdk.plugins.models import PluginRelease
 from synapse_sdk.plugins.upload import archive
 
 
-@click.command()
-@click.option('--host', required=True)
-@click.option('--access_token', required=True)
-@click.option('--debug_modules', default='', envvar='SYNAPSE_DEBUG_MODULES')
-@click.pass_context
-def publish(ctx, host, access_token, debug_modules):
-    debug = ctx.obj['DEBUG']
-
+def _publish(host, access_token, debug, debug_modules=''):
+    """
+    Publish a plugin release to the Synapse backend.
+
+    :param host: The host URL of the Synapse backend.
+    :param access_token: The access token for authentication.
+    :param debug_modules: Comma-separated list of debug modules.
+    """
     plugin_release = PluginRelease()
 
     source_path = Path('./')
@@ -29,8 +29,17 @@ def publish(ctx, host, access_token, debug_modules):
 
     client = BackendClient(host, access_token)
     client.create_plugin_release(data)
-    click.secho(
-        _('Successfully published "{}" ({}) to synapse backend!').format(plugin_release.name, plugin_release.code),
-        fg='green',
-        bold=True,
-    )
+
+    message = _('Successfully published "{}" ({}) to synapse backend!').format(plugin_release.name, plugin_release.code)
+    click.secho(message, fg='green', bold=True)
+    return plugin_release
+
+
+@click.command()
+@click.option('--host', required=True)
+@click.option('--access_token', required=True)
+@click.option('--debug_modules', default='', envvar='SYNAPSE_DEBUG_MODULES')
+@click.pass_context
+def publish(ctx, host, access_token, debug_modules):
+    debug = ctx.obj['DEBUG']
+    _publish(host, access_token, debug, debug_modules)

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk/devtools/server.py

@@ -1,6 +1,5 @@
 import json
 import logging
-import webbrowser
 from contextlib import asynccontextmanager
 from datetime import datetime
 from importlib.metadata import version
@@ -15,11 +14,13 @@ from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import StreamingResponse
 from fastapi.staticfiles import StaticFiles
 
+from synapse_sdk.cli.plugin.publish import _publish
 from synapse_sdk.clients.agent import AgentClient
 from synapse_sdk.clients.backend import BackendClient
 from synapse_sdk.clients.exceptions import ClientError
 from synapse_sdk.devtools.config import get_backend_config, load_devtools_config
 from synapse_sdk.devtools.models import ConfigResponse, ConfigUpdateRequest
+from synapse_sdk.devtools.utils import get_display_host
 
 logger = logging.getLogger(__name__)
 
@@ -93,32 +94,12 @@ class DevtoolsServer:
         """Internal method to publish plugin using CLI logic"""
         import os
 
-        from synapse_sdk.clients.backend import BackendClient
-        from synapse_sdk.plugins.models import PluginRelease
-        from synapse_sdk.plugins.upload import archive
-
-        # Change to plugin directory
         original_cwd = os.getcwd()
         try:
             os.chdir(str(source_path))
 
-            # Create plugin release from config in plugin directory
-            plugin_release = PluginRelease()
-
-            # Create archive
-            archive_path = source_path / 'dist' / 'archive.zip'
-            archive(source_path, archive_path)
-
-            # Prepare data for backend
-            data = {'plugin': plugin_release.plugin, 'file': str(archive_path), 'debug': debug}
-
-            if debug:
-                modules = []  # TODO: Get debug modules from environment or config
-                data['meta'] = {'modules': modules}
-
-            # Create backend client and publish
-            client = BackendClient(host, access_token, debug=debug)
-            result = client.create_plugin_release(data)
+            debug_modules = os.getenv('SYNAPSE_DEBUG_MODULES', '')
+            plugin_release = _publish(host, access_token, debug, debug_modules)
 
             return {
                 'success': True,
@@ -127,7 +108,7 @@ class DevtoolsServer:
                 'plugin_code': plugin_release.code,
                 'version': plugin_release.version,
                 'name': plugin_release.name,
-                'result': result,
+                'result': '',
             }
 
         finally:
@@ -263,9 +244,11 @@ class DevtoolsServer:
 
     def _inject_env_vars(self, html_content: str) -> str:
         """Inject environment variables into HTML"""
+        # Use display host for frontend access (resolves 0.0.0.0 to actual IP)
+        display_host = get_display_host(self.host)
         env_script = f"""<script>
         window.VITE_API_PORT = {self.port};
-        window.VITE_API_HOST = '{self.host}';
+        window.VITE_API_HOST = '{display_host}';
         </script>"""
 
         # Insert before closing head tag
@@ -360,14 +343,38 @@ class DevtoolsServer:
                 raise HTTPException(status_code=503, detail='Agent client not configured')
 
             async def log_generator():
+                import asyncio
+
                 try:
-                    # Use shorter timeout for log streaming to prevent hanging
-                    for log_line in self.agent_client.tail_job_logs(job_id, stream_timeout=5):
-                        # Check if client disconnected
+                    # Run the synchronous generator in a thread to avoid blocking
+                    loop = asyncio.get_event_loop()
+                    log_iter = self.agent_client.tail_job_logs(job_id, stream_timeout=3)
+
+                    while True:
+                        # Check if client disconnected before getting next log
                         if await request.is_disconnected():
                             logger.info(f'Client disconnected, stopping log stream for job {job_id}')
                             break
-                        yield log_line
+
+                        try:
+                            # Get next log line with timeout to allow periodic disconnect checks
+                            log_line = await loop.run_in_executor(None, lambda: next(log_iter, None))
+
+                            if log_line is None:
+                                break
+
+                            # Check again before yielding
+                            if await request.is_disconnected():
+                                logger.info(f'Client disconnected before yield, stopping log stream for job {job_id}')
+                                break
+
+                            # Convert plain text to SSE format
+                            if log_line.strip():
+                                yield f'data: {log_line.strip()}\n\n'
+
+                        except StopIteration:
+                            break
+
                 except ClientError as e:
                     logger.warning(f'Agent client error in log streaming for job {job_id}: {e.reason}')
                     if e.status == 408:
@@ -383,7 +390,7 @@ class DevtoolsServer:
                     logger.info(f'Log streaming ended for job {job_id}')
 
             try:
-                return StreamingResponse(log_generator(), media_type='text/plain')
+                return StreamingResponse(log_generator(), media_type='text/event-stream')
             except Exception as e:
                 logger.error(f'Failed to setup log stream for job {job_id}: {e}')
                 raise HTTPException(status_code=500, detail=f'Failed to setup log stream for job {job_id}')
@@ -786,40 +793,12 @@ class DevtoolsServer:
                     self.websocket_connections.remove(connection)
                     logger.info('Removed disconnected WebSocket connection')
 
-    def start_server(self, open_browser: bool = True):
+    def start_server(self):
         """Start the devtools server"""
-        url = f'http://{self.host}:{self.port}'
-
-        if open_browser:
-            # Open browser after a short delay to ensure server is ready
-            def open_browser_delayed():
-                import os
-                import time
-
-                time.sleep(1.5)
-
-                try:
-                    # Redirect stderr to suppress xdg-open error messages
-                    old_stderr = os.dup(2)
-                    with open(os.devnull, 'w') as devnull:
-                        os.dup2(devnull.fileno(), 2)
-                        webbrowser.open(url)
-                        os.dup2(old_stderr, 2)
-                        os.close(old_stderr)
-                except Exception:
-                    # Restore stderr if something went wrong
-                    try:
-                        os.dup2(old_stderr, 2)
-                        os.close(old_stderr)
-                    except Exception as e:
-                        logger.error(f'Failed to restore stderr: {e}')
-
-                # Always show the URL since we can't reliably detect browser success
-                print(f'Open devtools on your browser: {url}')
-
-            import threading
-
-            threading.Thread(target=open_browser_delayed, daemon=True).start()
+        # Use display host for browser opening and URL display
+        display_host = get_display_host(self.host)
+        url = f'http://{display_host}:{self.port}'
+        print(f'Open devtools on your browser: {url}')
 
         uvicorn.run(self.app, host=self.host, port=self.port, log_level='warning', access_log=False)
 

synapse_sdk-1.0.0a63/synapse_sdk/devtools/utils.py

@@ -0,0 +1,52 @@
+import socket
+
+
+def is_port_available(host: str, port: int) -> bool:
+    """Check if a port is available on the given host"""
+    try:
+        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sock:
+            sock.settimeout(1)
+            result = sock.connect_ex((host, port))
+            return result != 0
+    except (socket.error, OSError):
+        return False
+
+
+def find_available_port(host: str, start_port: int, max_attempts: int = 10) -> int:
+    """Find an available port starting from start_port"""
+    for port in range(start_port, start_port + max_attempts):
+        if is_port_available(host, port):
+            return port
+    raise RuntimeError(f'No available port found in range {start_port}-{start_port + max_attempts - 1}')
+
+
+def get_local_ip() -> str:
+    """Get the local IP address for client access"""
+    try:
+        # In WSL, return localhost since the server is accessible via localhost
+        if _is_wsl():
+            return '127.0.0.1'
+
+        with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as s:
+            s.connect(('8.8.8.8', 80))
+            return s.getsockname()[0]
+    except Exception:
+        # Fallback to localhost if we can't determine the local IP
+        return '127.0.0.1'
+
+
+def _is_wsl() -> bool:
+    """Check if we're running in WSL"""
+    try:
+        with open('/proc/version', 'r') as f:
+            content = f.read().lower()
+            return 'microsoft' in content or 'wsl' in content
+    except Exception:
+        return False
+
+
+def get_display_host(server_host: str) -> str:
+    """Get the appropriate host for display and frontend access"""
+    if server_host == '0.0.0.0':
+        return get_local_ip()
+    return server_host

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk/devtools/web/dist/index.html

@@ -6,8 +6,8 @@
     <meta name="theme-color" content="#000000" />
     <link rel="shortcut icon" type="image/ico" href="/assets/favicon-mtvwWgEY.ico" />
     <title>Synapse SDK</title>
-    <script type="module" crossorigin src="/assets/index-CUXTZIPM.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CFhy91rB.css">
+    <script type="module" crossorigin src="/assets/index-C-6muTAU.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DaWyc9aY.css">
   </head>
   <body>
     <noscript>You need to enable JavaScript to run this app.</noscript>

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk/devtools/web/src/components/LogViewer.jsx

@@ -186,6 +186,10 @@ export default function LogViewer(props) {
     startStreaming();
   });
 
+  onCleanup(() => {
+    stopStreaming();
+  });
+
   return (
     <div class="github-log-viewer">
       {/* Header */}
@@ -208,9 +212,19 @@ export default function LogViewer(props) {
         </div>
       </div>
 
+      {/* Error State */}
+      <Show when={error()}>
+        <div class="alert alert-error mb-2">
+          <svg xmlns="http://www.w3.org/2000/svg" class="stroke-current shrink-0 h-6 w-6" fill="none" viewBox="0 0 24 24">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 14l2-2m0 0l2-2m-2 2l-2-2m2 2l2 2m7-2a9 9 0 11-18 0 9 9 0 0118 0z" />
+          </svg>
+          <span>{error()}</span>
+        </div>
+      </Show>
+
       {/* Container */}
       <div class="log-container" ref={logContainerRef} onScroll={handleScroll}>
-        <Show when={logs().length === 0}>
+        <Show when={logs().length === 0 && !error()}>
           <div class="log-empty">
             <div class="empty-state">
               <svg class="empty-icon" viewBox="0 0 24 24" width="24" height="24">

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk/devtools/web/src/components/NavigationSidebar.jsx

@@ -1,6 +1,6 @@
 import { useLocation, useNavigate } from "@solidjs/router";
 import { createSignal, Show } from "solid-js";
-import { HomeIcon, DocumentIcon, SettingsIcon, CubeIcon, MenuIcon, CloseIcon } from "./icons";
+import { MenuIcon, CloseIcon, DocumentIcon } from "./icons";
 import { createStatusResource } from "../utils/api";
 
 export default function NavigationSidebar() {
@@ -15,23 +15,17 @@ export default function NavigationSidebar() {
     {
       id: "home",
       label: "Jobs",
-      icon: HomeIcon,
       path: "/",
-      description: "View and manage Ray jobs"
     },
     {
       id: "applications",
-      label: "Serve Apps",
-      icon: CubeIcon,
+      label: "Serve Application",
       path: "/serve_applications",
-      description: "Ray Serve applications"
     },
     {
       id: "plugin",
-      label: "Plugin Dev",
-      icon: SettingsIcon,
+      label: "Plugin",
       path: "/plugin",
-      description: "Develop and test plugins"
     }
   ];
 
@@ -89,7 +83,6 @@ export default function NavigationSidebar() {
       <nav class="flex-1 p-6 py-8 overflow-y-auto">
         <ul class="space-y-2">
           {navigationItems.map((item) => {
-            const Icon = item.icon;
             const active = isActive(item.path);
             
             return (
@@ -102,10 +95,8 @@ export default function NavigationSidebar() {
                   }`}
                   onClick={() => handleNavigation(item.path)}
                 >
-                  <Icon class="w-5 h-5 flex-shrink-0" />
                   <div class="flex-1 min-w-0">
                     <div class="text-sm font-medium">{item.label}</div>
-                    <div class="text-xs text-slate-500 truncate">{item.description}</div>
                   </div>
                 </button>
               </li>
@@ -120,7 +111,7 @@ export default function NavigationSidebar() {
           <div class="flex items-center justify-between">
             <span>SDK {status()?.devtools?.version || "Unknown"}</span>
             <a 
-              href="https://docs.synapse.ml" 
+              href="https://docs.synapse.sh"
               target="_blank" 
               rel="noopener noreferrer"
               class="text-slate-600 hover:text-slate-900"

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk/devtools/web/src/utils/api.js

@@ -333,12 +333,29 @@ export function createJobLogsStream(jobId) {
         const lines = buffer.split(/\r?\n/);
         buffer = lines.pop() || "";
 
-        const newLogs = lines
-          .filter(line => line.trim())
-          .map(parseLogLine);
-
-        if (newLogs.length > 0) {
-          setLogs(prev => [...prev, ...newLogs]);
+        for (const line of lines) {
+          if (!line.trim()) continue;
+          
+          // Handle SSE format (data: prefix)
+          if (line.startsWith('data: ')) {
+            const content = line.substring(6).trim();
+            
+            // Check if this is an error message from the server
+            if (content.includes('Agent client error') || 
+                content.includes('Agent connection error') ||
+                content.includes('Agent error:') ||
+                content.includes('Unexpected error:')) {
+              setError(content);
+              // Still add as a log entry so user can see the error
+              setLogs(prev => [...prev, parseLogLine(content)]);
+            } else {
+              // Normal log line
+              setLogs(prev => [...prev, parseLogLine(content)]);
+            }
+          } else {
+            // Handle non-SSE format (backward compatibility)
+            setLogs(prev => [...prev, parseLogLine(line)]);
+          }
         }
       }
 

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-sdk
-Version: 1.0.0a61
+Version: 1.0.0a63
 Summary: synapse sdk
 Author-email: datamaker <developer@datamaker.io>
 License: MIT

{synapse_sdk-1.0.0a61 → synapse_sdk-1.0.0a63}/synapse_sdk.egg-info/SOURCES.txt

@@ -9,7 +9,6 @@ requirements.txt
 uv.lock
 .github/workflows/lint.yml
 .github/workflows/pypi-publish.yml
-.github/workflows/update-changelog.yml
 docs/categories.md
 docs/changelog.md
 docs/configuration.md
@@ -105,6 +104,7 @@ synapse_sdk/devtools/__init__.py
 synapse_sdk/devtools/config.py
 synapse_sdk/devtools/models.py
 synapse_sdk/devtools/server.py
+synapse_sdk/devtools/utils.py
 synapse_sdk/devtools/docs/.gitignore
 synapse_sdk/devtools/docs/README.md
 synapse_sdk/devtools/docs/docusaurus.config.ts