cycls 0.0.2.69__py3-none-any.whl → 0.0.2.71__py3-none-any.whl

cycls/cli.py

@@ -0,0 +1,217 @@
+import sys
+import json
+import time
+import threading
+import httpx
+
+# ANSI codes
+DIM = "\033[2m"
+BOLD = "\033[1m"
+RESET = "\033[0m"
+CLEAR_LINE = "\r\033[K"
+GREEN = "\033[32m"
+YELLOW = "\033[33m"
+BLUE = "\033[34m"
+RED = "\033[31m"
+CYAN = "\033[36m"
+MAGENTA = "\033[35m"
+
+CALLOUT_STYLES = {
+    "success": ("✓", GREEN),
+    "warning": ("⚠", YELLOW),
+    "info": ("ℹ", BLUE),
+    "error": ("✗", RED),
+}
+
+def format_time(seconds):
+    if seconds < 60:
+        return f"{seconds:.1f}s"
+    return f"{int(seconds // 60)}m {int(seconds % 60)}s"
+
+def render_table(headers, rows):
+    if not headers:
+        return
+    widths = [len(str(h)) for h in headers]
+    for row in rows:
+        for i, cell in enumerate(row):
+            if i < len(widths):
+                widths[i] = max(widths[i], len(str(cell)))
+
+    top = "┌" + "┬".join("─" * (w + 2) for w in widths) + "┐"
+    sep = "├" + "┼".join("─" * (w + 2) for w in widths) + "┤"
+    bot = "└" + "┴".join("─" * (w + 2) for w in widths) + "┘"
+
+    def fmt_row(cells, bold=False):
+        parts = []
+        for i, w in enumerate(widths):
+            cell = str(cells[i]) if i < len(cells) else ""
+            if bold:
+                parts.append(f" {BOLD}{cell.ljust(w)}{RESET} ")
+            else:
+                parts.append(f" {cell.ljust(w)} ")
+        return "│" + "│".join(parts) + "│"
+
+    print(top)
+    print(fmt_row(headers, bold=True))
+    print(sep)
+    for row in rows:
+        print(fmt_row(row))
+    print(bot)
+
+class Spinner:
+    def __init__(self):
+        self.active = False
+        self.thread = None
+        self.frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
+
+    def start(self):
+        self.active = True
+        def spin():
+            i = 0
+            while self.active:
+                if not self.active:
+                    break
+                print(f"\r{MAGENTA}{self.frames[i % len(self.frames)]}{RESET} ", end="", flush=True)
+                for _ in range(8):  # Check active more frequently
+                    if not self.active:
+                        break
+                    time.sleep(0.01)
+                i += 1
+        self.thread = threading.Thread(target=spin, daemon=True)
+        self.thread.start()
+
+    def stop(self):
+        self.active = False
+        if self.thread:
+            self.thread.join(timeout=0.2)
+        print(f"{CLEAR_LINE}", end="", flush=True)
+
+def chat(url):
+    messages = []
+    endpoint = f"{url.rstrip('/')}/chat/cycls"
+
+    print(f"\n{MAGENTA}●{RESET} {BOLD}{url}{RESET}\n")
+
+    while True:
+        try:
+            user_input = input(f"{CYAN}❯{RESET} ")
+            if not user_input.strip():
+                continue
+
+            messages.append({"role": "user", "content": user_input})
+            print()
+
+            start_time = time.time()
+            in_thinking = False
+            table_headers = []
+            table_rows = []
+
+            with httpx.stream("POST", endpoint, json={"messages": messages}, timeout=None) as r:
+                for line in r.iter_lines():
+                    if line.startswith("data: ") and line != "data: [DONE]":
+
+                        data = json.loads(line[6:])
+                        msg_type = data.get("type")
+
+                        # Handle plain string or missing type
+                        if msg_type is None:
+                            # Could be OpenAI format or plain text
+                            if isinstance(data, str):
+                                print(data, end="", flush=True)
+                                continue
+                            elif "choices" in data:
+                                # OpenAI format
+                                content = data.get("choices", [{}])[0].get("delta", {}).get("content", "")
+                                if content:
+                                    print(content, end="", flush=True)
+                                continue
+                            elif "text" in data:
+                                print(data.get("text", ""), end="", flush=True)
+                                continue
+                            elif "content" in data:
+                                print(data.get("content", ""), end="", flush=True)
+                                continue
+                            else:
+                                # Debug: print raw data
+                                print(f"[debug: {data}]", end="", flush=True)
+                                continue
+
+                        # Close thinking if switching
+                        if msg_type != "thinking" and in_thinking:
+                            print(f"</thinking>{RESET}\n", end="", flush=True)
+                            in_thinking = False
+
+                        # Flush table if switching
+                        if msg_type != "table" and table_headers:
+                            render_table(table_headers, table_rows)
+                            table_headers = []
+                            table_rows = []
+
+                        if msg_type == "thinking":
+                            if not in_thinking:
+                                print(f"{DIM}<thinking>", end="", flush=True)
+                                in_thinking = True
+                            print(data.get("thinking", ""), end="", flush=True)
+
+                        elif msg_type == "text":
+                            print(data.get("text", ""), end="", flush=True)
+
+                        elif msg_type == "code":
+                            lang = data.get("language", "")
+                            print(f"\n```{lang}\n{data.get('code', '')}\n```\n", end="", flush=True)
+
+                        elif msg_type == "status":
+                            print(f"{DIM}[{data.get('status', '')}]{RESET} ", end="", flush=True)
+
+                        elif msg_type == "table":
+                            if "headers" in data:
+                                if table_headers:
+                                    render_table(table_headers, table_rows)
+                                table_headers = data["headers"]
+                                table_rows = []
+                            elif "row" in data:
+                                table_rows.append(data["row"])
+
+                        elif msg_type == "callout":
+                            style = data.get("style", "info")
+                            icon, color = CALLOUT_STYLES.get(style, ("•", RESET))
+                            title = data.get("title", "")
+                            text = data.get("callout", "")
+                            if title:
+                                print(f"\n{color}{icon} {BOLD}{title}{RESET}")
+                                print(f"{color}  {text}{RESET}\n", end="", flush=True)
+                            else:
+                                print(f"\n{color}{icon} {text}{RESET}\n", end="", flush=True)
+
+                        elif msg_type == "image":
+                            print(f"{DIM}[image: {data.get('src', '')}]{RESET}", end="", flush=True)
+
+            # Flush remaining
+            if table_headers:
+                render_table(table_headers, table_rows)
+            if in_thinking:
+                print(f"</thinking>{RESET}", end="", flush=True)
+
+            elapsed = time.time() - start_time
+            print(f"\n\n{DIM}✦ {format_time(elapsed)}{RESET}\n")
+
+        except KeyboardInterrupt:
+            continue
+        except EOFError:
+            print(f"{RESET}\n👋")
+            break
+        except (httpx.ReadError, httpx.ConnectError):
+            print(f"{RESET}🔄 Reconnecting...", end="", flush=True)
+            time.sleep(1)
+            print(CLEAR_LINE, end="")
+            if messages:
+                messages.pop()
+
+def main():
+    if len(sys.argv) < 3 or sys.argv[1] != "chat":
+        print("Usage: cycls chat <url>")
+        sys.exit(1)
+    chat(sys.argv[2])
+
+if __name__ == "__main__":
+    main()

cycls/runtime.py

@@ -337,6 +337,7 @@ COPY {self.payload_file} {self.io_dir}/
             return
 
         import inspect
+        import subprocess
 
         # Get the main script (the outermost .py file in the stack)
         main_script = None
@@ -362,75 +363,37 @@ COPY {self.payload_file} {self.io_dir}/
         print()
 
         while True:
-            # Run the container in a subprocess-like manner
-            print(f"🚀 Running function '{self.name}' in container...")
-            self._perform_auto_cleanup()
-            self._build_image_if_needed()
-
-            port = kwargs.get('port', None)
-            ports_mapping = {f'{port}/tcp': port} if port else None
-
-            with tempfile.TemporaryDirectory() as tmpdir_str:
-                tmpdir = Path(tmpdir_str)
-                payload_path = tmpdir / self.payload_file
-
-                with payload_path.open('wb') as f:
-                    cloudpickle.dump((self.func, args, kwargs), f)
+            # 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'}
+            )
 
-                container = self.docker_client.containers.create(
-                    image=self.tag,
-                    volumes={str(tmpdir): {'bind': self.io_dir, 'mode': 'rw'}},
-                    ports=ports_mapping,
-                    labels={self.managed_label: "true"}
-                )
-                container.start()
-                print(f"✅ Container running on port {port}")
-                print("👀 Waiting for file changes... (Ctrl+C to stop)\n")
+            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:
-                    # Watch for changes in a separate thread
-                    import threading
-                    import time
-                    change_detected = threading.Event()
-
-                    def watch_thread():
-                        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}")
-                            change_detected.set()
-                            break
-
-                    watcher = threading.Thread(target=watch_thread, daemon=True)
-                    watcher.start()
-
-                    # Stream container logs in separate thread
-                    def log_thread():
-                        for chunk in container.logs(stream=True, follow=True):
-                            if change_detected.is_set():
-                                break
-                            print(chunk.decode('utf-8').strip())
-
-                    logger = threading.Thread(target=log_thread, daemon=True)
-                    logger.start()
-
-                    # Wait for change or interrupt
-                    while not change_detected.is_set():
-                        time.sleep(0.5)
-
-                    print("\n🔄 Restarting...")
-                    container.stop(timeout=2)
-                    container.remove()
-                    # Re-exec the main script
-                    print(f"🔄 Re-executing {main_script.name}...\n")
-                    os.execv(sys.executable, [sys.executable, str(main_script)])
-
-                except KeyboardInterrupt:
-                    print("\n🛑 Stopping...")
-                    container.stop(timeout=2)
-                    container.remove()
-                    return
+                    proc.wait(timeout=3)
+                except subprocess.TimeoutExpired:
+                    proc.kill()
+                return
 
     def build(self, *args, **kwargs):
         """Builds a self-contained, deployable Docker image locally."""

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,19 +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, watch=False):
+    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
-        if prod and watch:
-            print("⚠️  Warning: watch=True ignored in production mode.")
-            watch = False
+            return None
 
         agent = self.registered_functions[0]
         if len(self.registered_functions) > 1:
@@ -112,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,
@@ -121,13 +117,24 @@ class Agent:
             base_url=self.base_url,
             api_key=self.key
         )
-        if prod:
-            new.deploy(port=port)
-        elif watch:
-            new.watch(port=port)
-        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.69.dist-info → cycls-0.0.2.71.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cycls
-Version: 0.0.2.69
+Version: 0.0.2.71
 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.69.dist-info → cycls-0.0.2.71.dist-info}/RECORD

@@ -1,12 +1,14 @@
 cycls/__init__.py,sha256=bVT0dYTXLdSC3ZURgtm-DEOj-VO6RUM6zGsJB0zuj6Y,61
 cycls/auth.py,sha256=xkndHZyCfnlertMMEKerCJjf23N3fVcTRVTTSXTTuzg,247
+cycls/cli.py,sha256=AKf0z7ZLau3GvBVR_IhB7agmq4nVaHkcuUafNyvv2_A,7978
 cycls/default-theme/assets/index-B0ZKcm_V.css,sha256=wK9-NhEB8xPcN9Zv69zpOcfGTlFbMwyC9WqTmSKUaKw,6546
 cycls/default-theme/assets/index-D5EDcI4J.js,sha256=sN4qRcAXa7DBd9JzmVcCoCwH4l8cNCM-U9QGUjBvWSo,1346506
 cycls/default-theme/index.html,sha256=bM-yW_g0cGrV40Q5yY3ccY0fM4zI1Wuu5I8EtGFJIxs,828
 cycls/dev-theme/index.html,sha256=QJBHkdNuMMiwQU7o8dN8__8YQeQB45D37D-NCXIWB2Q,11585
-cycls/runtime.py,sha256=BaP5sLG3NLPQZwuKwoYueC3R5WeuNg2-YzOQes6paUE,23221
-cycls/sdk.py,sha256=iOSFFPSN2iGCTIL2ZBOpb2X5jjUEm7gQbAuanYHF4qg,6974
+cycls/runtime.py,sha256=LgOrQ6Arh-GWSJqckfra-CvjeSekTvGvjHOBxu7JTQQ,21408
+cycls/sdk.py,sha256=6oRKP44TJN9HKdNw9OYzDlZFDUMUhoCMt8TEwyu26dI,7368
 cycls/web.py,sha256=3M3qaWTNY3dpgd7Vq5aXREp-cIFsHrDqBQ1YkGrOaUk,4659
-cycls-0.0.2.69.dist-info/METADATA,sha256=3nG949VOjQ1K-sftwDGsAQheGAt-GCKWGUmDgUBgOP4,7943
-cycls-0.0.2.69.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-cycls-0.0.2.69.dist-info/RECORD,,
+cycls-0.0.2.71.dist-info/METADATA,sha256=MG66f3JLtPXNMLV1rCs29BYkBxk2B3aMIG5_azsD9HI,8008
+cycls-0.0.2.71.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+cycls-0.0.2.71.dist-info/entry_points.txt,sha256=vEhqUxFhhuzCKWtq02LbMnT3wpUqdfgcM3Yh-jjXom8,40
+cycls-0.0.2.71.dist-info/RECORD,,

cycls-0.0.2.71.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+cycls=cycls.cli:main
+