cycls 0.0.2.89__tar.gz → 0.0.2.91__tar.gz

cycls-0.0.2.89/README.md → cycls-0.0.2.91/PKG-INFO

@@ -1,10 +1,28 @@
+Metadata-Version: 2.4
+Name: cycls
+Version: 0.0.2.91
+Summary: Distribute Intelligence
+Author-email: "Mohammed J. AlRujayi" <mj@cycls.com>
+Requires-Python: >=3.10
+Requires-Dist: agentfs-sdk==0.4.0
+Requires-Dist: cloudpickle>=3.1.1
+Requires-Dist: docker>=7.1.0
+Requires-Dist: email-validator>=2.0.0
+Requires-Dist: fastapi>=0.111.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pyjwt>=2.8.0
+Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: watchfiles>=1.0.0
+Description-Content-Type: text/markdown
+
 <h3 align="center">
 Distribute Intelligence
 </h3>
 
 <h4 align="center">
   <a href="https://cycls.com">Website</a> |
-  <a href="https://docs.cycls.com">Docs</a>
+  <a href="https://docs.cycls.com">Docs</a> |
+  <a href="docs/tutorial.md">Tutorial</a>
 </h4>
 
 <h4 align="center">
@@ -64,7 +82,7 @@ app.deploy()  # Live at https://agent.cycls.ai
 pip install cycls
 ```
 
-Requires Docker.
+Requires Docker. See the [full tutorial](docs/tutorial.md) for a comprehensive guide.
 
 ## What You Get
 
@@ -87,6 +105,8 @@ Get an API key at [cycls.com](https://cycls.com).
 
 ## Authentication & Analytics
 
+See the [tutorial](docs/tutorial.md#authentication) for full auth and monetization examples.
+
 ```python
 @cycls.app(pip=["openai"], auth=True, analytics=True)
 async def app(context):
@@ -103,7 +123,7 @@ async def app(context):
 
 ## Native UI Components
 
-Yield structured objects for rich streaming responses:
+Yield structured objects for rich streaming responses. See the [tutorial](docs/tutorial.md#native-ui-components) for all component types and examples.
 
 ```python
 @cycls.app()
@@ -178,7 +198,7 @@ See [docs/streaming-protocol.md](docs/streaming-protocol.md) for frontend integr
 
 ## Declarative Infrastructure
 
-Define your entire runtime in the decorator:
+Define your entire runtime in the decorator. See the [tutorial](docs/tutorial.md#declarative-infrastructure) for more details.
 
 ```python
 @cycls.app(
@@ -249,6 +269,13 @@ Access them at `https://your-app.cycls.ai/public/logo.png`.
 
 No YAML. No Dockerfiles. No infrastructure repo. The code is the deployment.
 
+## Learn More
+
+- [Tutorial](docs/tutorial.md) - Comprehensive guide from basics to advanced
+- [Streaming Protocol](docs/streaming-protocol.md) - Frontend integration
+- [Runtime](docs/runtime.md) - Containerization details
+- [Examples](examples/) - Working code samples
+
 ## License
 
 MIT

cycls-0.0.2.89/PKG-INFO → cycls-0.0.2.91/README.md

@@ -1,25 +1,11 @@
-Metadata-Version: 2.4
-Name: cycls
-Version: 0.0.2.89
-Summary: Distribute Intelligence
-Author-email: "Mohammed J. AlRujayi" <mj@cycls.com>
-Requires-Python: >=3.9
-Requires-Dist: cloudpickle>=3.1.1
-Requires-Dist: docker>=7.1.0
-Requires-Dist: email-validator>=2.0.0
-Requires-Dist: fastapi>=0.111.0
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: pyjwt>=2.8.0
-Requires-Dist: uvicorn>=0.30.0
-Description-Content-Type: text/markdown
-
 <h3 align="center">
 Distribute Intelligence
 </h3>
 
 <h4 align="center">
   <a href="https://cycls.com">Website</a> |
-  <a href="https://docs.cycls.com">Docs</a>
+  <a href="https://docs.cycls.com">Docs</a> |
+  <a href="docs/tutorial.md">Tutorial</a>
 </h4>
 
 <h4 align="center">
@@ -79,7 +65,7 @@ app.deploy()  # Live at https://agent.cycls.ai
 pip install cycls
 ```
 
-Requires Docker.
+Requires Docker. See the [full tutorial](docs/tutorial.md) for a comprehensive guide.
 
 ## What You Get
 
@@ -102,6 +88,8 @@ Get an API key at [cycls.com](https://cycls.com).
 
 ## Authentication & Analytics
 
+See the [tutorial](docs/tutorial.md#authentication) for full auth and monetization examples.
+
 ```python
 @cycls.app(pip=["openai"], auth=True, analytics=True)
 async def app(context):
@@ -118,7 +106,7 @@ async def app(context):
 
 ## Native UI Components
 
-Yield structured objects for rich streaming responses:
+Yield structured objects for rich streaming responses. See the [tutorial](docs/tutorial.md#native-ui-components) for all component types and examples.
 
 ```python
 @cycls.app()
@@ -193,7 +181,7 @@ See [docs/streaming-protocol.md](docs/streaming-protocol.md) for frontend integr
 
 ## Declarative Infrastructure
 
-Define your entire runtime in the decorator:
+Define your entire runtime in the decorator. See the [tutorial](docs/tutorial.md#declarative-infrastructure) for more details.
 
 ```python
 @cycls.app(
@@ -264,6 +252,13 @@ Access them at `https://your-app.cycls.ai/public/logo.png`.
 
 No YAML. No Dockerfiles. No infrastructure repo. The code is the deployment.
 
+## Learn More
+
+- [Tutorial](docs/tutorial.md) - Comprehensive guide from basics to advanced
+- [Streaming Protocol](docs/streaming-protocol.md) - Frontend integration
+- [Runtime](docs/runtime.md) - Containerization details
+- [Examples](examples/) - Working code samples
+
 ## License
 
 MIT

{cycls-0.0.2.89 → cycls-0.0.2.91}/cycls/app.py

@@ -14,12 +14,14 @@ class App(Function):
     """App extends Function with web UI serving capabilities."""
 
     def __init__(self, func, name, theme="default", pip=None, apt=None, copy=None, copy_public=None,
-                 auth=False, org=None, header=None, intro=None, title=None, plan="free", analytics=False):
+                 auth=False, org=None, header=None, intro=None, title=None, plan="free", analytics=False,
+                 state=False):
         if theme not in THEMES:
             raise ValueError(f"Unknown theme: {theme}. Available: {THEMES}")
         self.user_func = func
         self.theme = theme
         self.copy_public = copy_public or []
+        self.state = state
 
         self.config = Config(
             header=header,
@@ -29,6 +31,7 @@ class App(Function):
             plan=plan,
             analytics=analytics,
             org=org,
+            state=state,
         )
 
         # Build files dict for Function (theme is inside cycls/)
@@ -39,7 +42,7 @@ class App(Function):
         super().__init__(
             func=func,
             name=name,
-            pip=["fastapi[standard]", "pyjwt", "cryptography", "uvicorn", "python-dotenv", "docker", *(pip or [])],
+            pip=["fastapi[standard]", "pyjwt", "cryptography", "uvicorn", "python-dotenv", "docker", "agentfs-sdk", "pyturso==0.4.0rc17", *(pip or [])],
             apt=apt,
             copy=files,
             base_url=_get_base_url(),
@@ -51,7 +54,6 @@ class App(Function):
 
     def _prepare_func(self, prod):
         self.config.set_prod(prod)
-        self.config.debug = not prod  # debug=True in local mode
         self.config.public_path = f"cycls/themes/{self.theme}"
         user_func, config, name = self.user_func, self.config, self.name
         self.func = lambda port: __import__("cycls").web.serve(user_func, config, name, port)
@@ -61,7 +63,6 @@ class App(Function):
         print(f"Starting local server at localhost:{port}")
         self.config.public_path = str(CYCLS_PATH.joinpath(f"themes/{self.theme}"))
         self.config.set_prod(False)
-        self.config.debug = True
         uvicorn.run(web(self.user_func, self.config), host="0.0.0.0", port=port)
 
     def local(self, port=8080, watch=True):

cycls-0.0.2.91/cycls/state.py

@@ -0,0 +1,6 @@
+from agentfs_sdk import AgentFS, AgentFSOptions
+
+
+async def create_state(user_id: str = "default"):
+    """Create state instance scoped to end-user."""
+    return await AgentFS.open(AgentFSOptions(id=user_id))