cycls 0.0.2.68__tar.gz → 0.0.2.70__tar.gz

{cycls-0.0.2.68 → cycls-0.0.2.70}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cycls
-Version: 0.0.2.68
+Version: 0.0.2.70
 Summary: Distribute Intelligence
 Author: Mohammed J. AlRujayi
 Author-email: mj@cycls.com
@@ -70,7 +70,7 @@ async def chat(context):
         if chunk.choices[0].delta.content:
             yield chunk.choices[0].delta.content
 
-agent.deploy(prod=True)  # Live at https://my-agent.cycls.ai
+agent.deploy()  # Live at https://my-agent.cycls.ai
 ```
 
 ## Installation
@@ -90,11 +90,12 @@ Requires Docker.
 - **Monetization** - `tier="cycls_pass"` integrates with [Cycls Pass](https://cycls.ai) subscriptions
 - **Native UI Components** - Render thinking bubbles, tables, code blocks in responses
 
-## Deploying
+## Running
 
 ```python
-agent.deploy(prod=False)  # Development: localhost:8080
-agent.deploy(prod=True)   # Production: https://agent-name.cycls.ai
+agent.local()             # Development with hot-reload (localhost:8080)
+agent.local(watch=False)  # Development without hot-reload
+agent.deploy()            # Production: https://agent-name.cycls.ai
 ```
 
 Get an API key at [cycls.com](https://cycls.com).

{cycls-0.0.2.68 → cycls-0.0.2.70}/README.md

@@ -47,7 +47,7 @@ async def chat(context):
         if chunk.choices[0].delta.content:
             yield chunk.choices[0].delta.content
 
-agent.deploy(prod=True)  # Live at https://my-agent.cycls.ai
+agent.deploy()  # Live at https://my-agent.cycls.ai
 ```
 
 ## Installation
@@ -67,11 +67,12 @@ Requires Docker.
 - **Monetization** - `tier="cycls_pass"` integrates with [Cycls Pass](https://cycls.ai) subscriptions
 - **Native UI Components** - Render thinking bubbles, tables, code blocks in responses
 
-## Deploying
+## Running
 
 ```python
-agent.deploy(prod=False)  # Development: localhost:8080
-agent.deploy(prod=True)   # Production: https://agent-name.cycls.ai
+agent.local()             # Development with hot-reload (localhost:8080)
+agent.local(watch=False)  # Development without hot-reload
+agent.deploy()            # Production: https://agent-name.cycls.ai
 ```
 
 Get an API key at [cycls.com](https://cycls.com).

{cycls-0.0.2.68 → cycls-0.0.2.70}/cycls/runtime.py

@@ -9,6 +9,9 @@ from pathlib import Path
 from contextlib import contextmanager
 import tarfile
 
+# Enable BuildKit for faster builds with better caching
+os.environ["DOCKER_BUILDKIT"] = "1"
+
 # --- Top-Level Helper Functions ---
 
 def _bootstrap_script(payload_file: str, result_file: str) -> str:
@@ -325,6 +328,73 @@ COPY {self.payload_file} {self.io_dir}/
             print(f"\n🛑 Operation stopped: {e}")
             return None
 
+    def watch(self, *args, **kwargs):
+        """Runs the container with file watching - restarts script on changes."""
+        try:
+            from watchfiles import watch as watchfiles_watch
+        except ImportError:
+            print("❌ watchfiles not installed. Run: pip install watchfiles")
+            return
+
+        import inspect
+        import subprocess
+
+        # Get the main script (the outermost .py file in the stack)
+        main_script = None
+        for frame_info in inspect.stack():
+            filename = frame_info.filename
+            if filename.endswith('.py') and not filename.startswith('<'):
+                main_script = Path(filename).resolve()
+        # main_script is now the outermost/first script in the call chain
+
+        # Build watch paths: main script + copy sources
+        watch_paths = []
+        if main_script and main_script.exists():
+            watch_paths.append(main_script)
+        watch_paths.extend([Path(src).resolve() for src in self.copy.keys() if Path(src).exists()])
+
+        if not watch_paths:
+            print("⚠️  No files to watch. Running without watch mode.")
+            return self.run(*args, **kwargs)
+
+        print(f"👀 Watching for changes:")
+        for p in watch_paths:
+            print(f"   {p}")
+        print()
+
+        while True:
+            # Run the script in a subprocess so we survive errors
+            print(f"🚀 Running {main_script.name}...")
+            proc = subprocess.Popen(
+                [sys.executable, str(main_script)],
+                env={**os.environ, '_CYCLS_WATCH_CHILD': '1'}
+            )
+
+            try:
+                # Watch for changes
+                for changes in watchfiles_watch(*watch_paths):
+                    changed_files = [str(c[1]) for c in changes]
+                    print(f"\n🔄 Changes detected:")
+                    for f in changed_files:
+                        print(f"   {f}")
+                    break
+
+                print("\n🔄 Restarting...\n")
+                proc.terminate()
+                try:
+                    proc.wait(timeout=3)
+                except subprocess.TimeoutExpired:
+                    proc.kill()
+
+            except KeyboardInterrupt:
+                print("\n🛑 Stopping...")
+                proc.terminate()
+                try:
+                    proc.wait(timeout=3)
+                except subprocess.TimeoutExpired:
+                    proc.kill()
+                return
+
     def build(self, *args, **kwargs):
         """Builds a self-contained, deployable Docker image locally."""
         print("📦 Building self-contained image for deployment...")

{cycls-0.0.2.68 → cycls-0.0.2.70}/cycls/sdk.py

@@ -1,4 +1,4 @@
-import time, inspect, uvicorn
+import os, time, inspect, uvicorn
 from .runtime import Runtime
 from .web import web, Config
 from .auth import PK_LIVE, PK_TEST, JWKS_PROD, JWKS_TEST
@@ -74,7 +74,8 @@ class Agent:
             return f
         return decorator
 
-    def local(self, port=8080):
+    def _local(self, port=8080, watch=True):
+        """Run directly with uvicorn (no Docker)."""
         if not self.registered_functions:
             print("Error: No @agent decorated function found.")
             return
@@ -85,16 +86,14 @@ class Agent:
         print(f"🚀 Starting local server at localhost:{port}")
         agent.config.public_path = self.theme
         set_prod(agent.config, False)
-        uvicorn.run(web(agent.func, agent.config), host="0.0.0.0", port=port)
+        uvicorn.run(web(agent.func, agent.config), host="0.0.0.0", port=port, reload=watch)
         return
 
-    def deploy(self, prod=False, port=8080):
+    def _runtime(self, prod=False):
+        """Create a Runtime instance for the first registered agent."""
         if not self.registered_functions:
             print("Error: No @agent decorated function found.")
-            return
-        if (self.key is None) and prod:
-            print("🛑  Error: Please add your Cycls API key")
-            return
+            return None
 
         agent = self.registered_functions[0]
         if len(self.registered_functions) > 1:
@@ -109,7 +108,7 @@ class Agent:
         files.update({f: f for f in self.copy})
         files.update({f: f"public/{f}" for f in self.copy_public})
 
-        new = Runtime(
+        return Runtime(
             func=lambda port: __import__("web").serve(func, config_dict, name, port),
             name=name,
             apt_packages=self.apt,
@@ -118,8 +117,24 @@ class Agent:
             base_url=self.base_url,
             api_key=self.key
         )
-        new.deploy(port=port) if prod else new.run(port=port)
-        return
+
+    def local(self, port=8080, watch=True):
+        """Run locally in Docker with file watching by default."""
+        # Child process spawned by watcher - run without watch
+        if os.environ.get('_CYCLS_WATCH_CHILD'):
+            watch = False
+        runtime = self._runtime(prod=False)
+        if runtime:
+            runtime.watch(port=port) if watch else runtime.run(port=port)
+
+    def deploy(self, port=8080):
+        """Deploy to production."""
+        if self.key is None:
+            print("🛑  Error: Please add your Cycls API key")
+            return
+        runtime = self._runtime(prod=True)
+        if runtime:
+            runtime.deploy(port=port)
         
     def modal(self, prod=False):
         import modal

{cycls-0.0.2.68 → cycls-0.0.2.70}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "cycls"
-version = "0.0.2.68"
+version = "0.0.2.70"
 
 packages = [{ include = "cycls" }]
 include = ["cycls/theme/**/*"]