cycls 0.0.2.93__py3-none-any.whl

cycls/themes/default/assets/index-oGkkm3Z8.css

@@ -0,0 +1 @@
+:root{--bg-primary: #ffffff;--bg-secondary: #f9fafb;--bg-tertiary: #f3f4f6;--bg-sidebar: rgba(255, 255, 255, .8);--bg-hover: rgba(0, 0, 0, .05);--bg-active: rgba(0, 0, 0, .07);--bg-overlay: rgba(0, 0, 0, .25);--text-primary: #0d0d0d;--text-secondary: #374151;--text-tertiary: #6b6b6b;--text-muted: #9ca3af;--border-primary: rgba(0, 0, 0, .1);--border-secondary: rgba(0, 0, 0, .06);--accent-primary: #10a37f;--accent-hover: #0d8a6c;--scrollbar-thumb: #d1d1d1;--scrollbar-thumb-hover: #b1b1b1;--shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, .05);--shadow-md: 0 4px 6px -1px rgba(0, 0, 0, .1), 0 2px 4px -1px rgba(0, 0, 0, .06);--shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, .1), 0 4px 6px -2px rgba(0, 0, 0, .05);--code-bg: #f3f4f6;--code-text: #1f2937;--msg-user-bg: #f3f4f6;--msg-assistant-bg: transparent;--input-bg: #ffffff;--input-border: #e5e7eb;--input-focus-border: #10a37f;--btn-primary-bg: #0d0d0d;--btn-primary-text: #ffffff;--btn-secondary-bg: transparent;--btn-secondary-text: #0d0d0d}.dark,[data-theme=dark]{--bg-primary: #212121;--bg-secondary: #171717;--bg-tertiary: #2f2f2f;--bg-sidebar: rgba(23, 23, 23, .95);--bg-hover: rgba(255, 255, 255, .08);--bg-active: rgba(255, 255, 255, .12);--bg-overlay: rgba(0, 0, 0, .5);--text-primary: #ececec;--text-secondary: #c5c5c5;--text-tertiary: #8e8e8e;--text-muted: #6b6b6b;--border-primary: rgba(255, 255, 255, .1);--border-secondary: rgba(255, 255, 255, .06);--accent-primary: #10a37f;--accent-hover: #1abc94;--scrollbar-thumb: #4a4a4a;--scrollbar-thumb-hover: #5a5a5a;--shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, .3);--shadow-md: 0 4px 6px -1px rgba(0, 0, 0, .4), 0 2px 4px -1px rgba(0, 0, 0, .3);--shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, .4), 0 4px 6px -2px rgba(0, 0, 0, .3);--code-bg: #2f2f2f;--code-text: #e5e7eb;--msg-user-bg: #2f2f2f;--msg-assistant-bg: transparent;--input-bg: #2f2f2f;--input-border: #424242;--input-focus-border: #10a37f;--btn-primary-bg: #ececec;--btn-primary-text: #0d0d0d;--btn-secondary-bg: transparent;--btn-secondary-text: #ececec}@media(prefers-color-scheme:dark){:root:not(.light):not([data-theme=light]){--bg-primary: #212121;--bg-secondary: #171717;--bg-tertiary: #2f2f2f;--bg-sidebar: rgba(23, 23, 23, .95);--bg-hover: rgba(255, 255, 255, .08);--bg-active: rgba(255, 255, 255, .12);--bg-overlay: rgba(0, 0, 0, .5);--text-primary: #ececec;--text-secondary: #c5c5c5;--text-tertiary: #8e8e8e;--text-muted: #6b6b6b;--border-primary: rgba(255, 255, 255, .1);--border-secondary: rgba(255, 255, 255, .06);--accent-primary: #10a37f;--accent-hover: #1abc94;--scrollbar-thumb: #4a4a4a;--scrollbar-thumb-hover: #5a5a5a;--shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, .3);--shadow-md: 0 4px 6px -1px rgba(0, 0, 0, .4), 0 2px 4px -1px rgba(0, 0, 0, .3);--shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, .4), 0 4px 6px -2px rgba(0, 0, 0, .3);--code-bg: #2f2f2f;--code-text: #e5e7eb;--msg-user-bg: #2f2f2f;--msg-assistant-bg: transparent;--input-bg: #2f2f2f;--input-border: #424242;--input-focus-border: #10a37f;--btn-primary-bg: #ececec;--btn-primary-text: #0d0d0d;--btn-secondary-bg: transparent;--btn-secondary-text: #ececec}}body{background-color:var(--bg-primary);color:var(--text-primary);transition:background-color .2s ease,color .2s ease}.cl-internal-p8bmz4{box-shadow:none!important;border:1px solid var(--border-primary);box-shadow:var(--shadow-sm)}.cl-drawerRoot{z-index:99!important}.cl-pricingTableCardFooterButton{padding:10px}.cl-pricingTableCardFee{font-size:2rem}.cl-pricingTableCardTitleContainer{margin-bottom:10px}.scrollbar-thin{scrollbar-width:thin;scrollbar-color:var(--scrollbar-thumb) transparent}.scrollbar-thin::-webkit-scrollbar{width:6px}.scrollbar-thin::-webkit-scrollbar-track{background:transparent}.scrollbar-thin::-webkit-scrollbar-thumb{background-color:var(--scrollbar-thumb);border-radius:3px}.scrollbar-thin::-webkit-scrollbar-thumb:hover{background-color:var(--scrollbar-thumb-hover)}.scrollbar-thin::-webkit-scrollbar-thumb{background-color:transparent}.scrollbar-thin:hover::-webkit-scrollbar-thumb{background-color:var(--scrollbar-thumb)}.sidebar-transition{transition:transform .3s ease-in-out,width .3s ease-in-out}.sidebar-overlay{z-index:40}.sidebar-panel{z-index:50}@keyframes slideDown{0%{opacity:0;transform:translateY(-4px)}to{opacity:1;transform:translateY(0)}}.dropdown-menu{animation:slideDown .15s ease-out}.sidebar-item:focus-visible{outline:2px solid var(--text-primary);outline-offset:-2px;border-radius:8px}.user-profile-item:hover .user-avatar{transform:scale(1.02)}.chat-title-fade{mask-image:linear-gradient(to right,black 85%,transparent 100%);-webkit-mask-image:linear-gradient(to right,black 85%,transparent 100%)}.theme-toggle-icon{transition:transform .3s ease,opacity .2s ease}.theme-toggle:hover .theme-toggle-icon{transform:rotate(15deg)}.theme-transition{transition:background-color .2s ease,color .2s ease,border-color .2s ease,box-shadow .2s ease}.dark .prose,[data-theme=dark] .prose{--tw-prose-body: var(--text-primary);--tw-prose-headings: var(--text-primary);--tw-prose-lead: var(--text-secondary);--tw-prose-links: var(--accent-primary);--tw-prose-bold: var(--text-primary);--tw-prose-counters: var(--text-tertiary);--tw-prose-bullets: var(--text-tertiary);--tw-prose-hr: var(--border-primary);--tw-prose-quotes: var(--text-secondary);--tw-prose-quote-borders: var(--border-primary);--tw-prose-captions: var(--text-tertiary);--tw-prose-code: var(--text-primary);--tw-prose-pre-code: var(--code-text);--tw-prose-pre-bg: var(--code-bg);--tw-prose-th-borders: var(--border-primary);--tw-prose-td-borders: var(--border-secondary)}@media(prefers-color-scheme:dark){:root:not(.light):not([data-theme=light]) .prose{--tw-prose-body: var(--text-primary);--tw-prose-headings: var(--text-primary);--tw-prose-lead: var(--text-secondary);--tw-prose-links: var(--accent-primary);--tw-prose-bold: var(--text-primary);--tw-prose-counters: var(--text-tertiary);--tw-prose-bullets: var(--text-tertiary);--tw-prose-hr: var(--border-primary);--tw-prose-quotes: var(--text-secondary);--tw-prose-quote-borders: var(--border-primary);--tw-prose-captions: var(--text-tertiary);--tw-prose-code: var(--text-primary);--tw-prose-pre-code: var(--code-text);--tw-prose-pre-bg: var(--code-bg);--tw-prose-th-borders: var(--border-primary);--tw-prose-td-borders: var(--border-secondary)}}.dark pre code.hljs,[data-theme=dark] pre code.hljs{background:var(--code-bg)!important}@media(prefers-color-scheme:dark){:root:not(.light):not([data-theme=light]) pre code.hljs{background:var(--code-bg)!important}}

cycls/themes/default/index.html

@@ -0,0 +1,32 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>AI Agent</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <!-- Default SEO tags - dynamically updated by SEOHead component -->
+    <meta name="robots" content="noindex, nofollow" />
+    <meta name="googlebot" content="noindex, nofollow" />
+    <meta name="description" content="AI-powered chat interface" />
+    <script src="https://cdn.tailwindcss.com?plugins=forms,typography"></script>
+    <link
+      rel="stylesheet"
+      href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/styles/github-dark.min.css"
+    />
+    <link
+      rel="stylesheet"
+      href="https://esm.sh/katex@0.16.8/dist/katex.min.css"
+    />
+    <script type="module" crossorigin src="/assets/index-Xh0IeurI.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-oGkkm3Z8.css">
+  </head>
+  <body style="overflow-x: hidden">
+    <div id="root"></div>
+
+    <script>
+      tailwind.config = {
+        darkMode: "class",
+      };
+    </script>
+  </body>
+</html>

cycls/themes/dev/index.html

@@ -0,0 +1,298 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>Spark - Native Components</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <script src="https://cdn.tailwindcss.com?plugins=forms,typography"></script>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/github-dark.min.css" />
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
+    <script>
+      tailwind.config = { darkMode: "class" };
+    </script>
+    <style>
+      :root {
+        --bg-primary: #ffffff;
+        --bg-secondary: #f9fafb;
+        --text-primary: #0d0d0d;
+        --text-secondary: #6b7280;
+        --border-color: #e5e7eb;
+        --accent: #10a37f;
+      }
+      .dark {
+        --bg-primary: #212121;
+        --bg-secondary: #171717;
+        --text-primary: #ececec;
+        --text-secondary: #9ca3af;
+        --border-color: #374151;
+        --accent: #10a37f;
+      }
+      body {
+        background: var(--bg-primary);
+        color: var(--text-primary);
+      }
+      .thinking-bubble {
+        background: linear-gradient(135deg, #f3f4f6 0%, #e5e7eb 100%);
+        border-left: 3px solid var(--accent);
+      }
+      .dark .thinking-bubble {
+        background: linear-gradient(135deg, #374151 0%, #1f2937 100%);
+      }
+      .callout-info { border-left-color: #3b82f6; background: #eff6ff; }
+      .callout-warning { border-left-color: #f59e0b; background: #fffbeb; }
+      .callout-error { border-left-color: #ef4444; background: #fef2f2; }
+      .callout-success { border-left-color: #10b981; background: #ecfdf5; }
+      .dark .callout-info { background: #1e3a5f; }
+      .dark .callout-warning { background: #422006; }
+      .dark .callout-error { background: #450a0a; }
+      .dark .callout-success { background: #064e3b; }
+      @keyframes pulse-border {
+        0%, 100% { border-color: var(--accent); }
+        50% { border-color: transparent; }
+      }
+      .streaming { animation: pulse-border 1s infinite; }
+    </style>
+  </head>
+  <body class="dark">
+    <div id="app" class="min-h-screen flex flex-col">
+      <!-- Header -->
+      <header class="border-b border-[var(--border-color)] p-4">
+        <div class="max-w-3xl mx-auto flex items-center justify-between">
+          <h1 class="text-xl font-semibold">Spark</h1>
+          <button onclick="toggleDark()" class="p-2 rounded hover:bg-[var(--bg-secondary)]">
+            <span id="theme-icon">🌙</span>
+          </button>
+        </div>
+      </header>
+
+      <!-- Messages -->
+      <main class="flex-1 overflow-y-auto p-4">
+        <div id="messages" class="max-w-3xl mx-auto space-y-4"></div>
+      </main>
+
+      <!-- Input -->
+      <footer class="border-t border-[var(--border-color)] p-4">
+        <form id="chat-form" class="max-w-3xl mx-auto flex gap-2">
+          <input
+            type="text"
+            id="input"
+            placeholder="Send a message..."
+            class="flex-1 rounded-lg border border-[var(--border-color)] bg-[var(--bg-secondary)] px-4 py-3 text-[var(--text-primary)] focus:outline-none focus:ring-2 focus:ring-[var(--accent)]"
+          />
+          <button
+            type="submit"
+            class="rounded-lg bg-[var(--accent)] px-6 py-3 text-white font-medium hover:opacity-90"
+          >
+            Send
+          </button>
+        </form>
+      </footer>
+    </div>
+
+    <script>
+      // State
+      let messages = [];
+      let isDark = true;
+
+      // Toggle dark mode
+      function toggleDark() {
+        isDark = !isDark;
+        document.body.classList.toggle('dark', isDark);
+        document.getElementById('theme-icon').textContent = isDark ? '🌙' : '☀️';
+      }
+
+      // Native component renderers
+      const components = {
+        text: (props) => marked.parse(props.text || '', { breaks: true }),
+
+        thinking: (props) => `
+          <div class="thinking-bubble rounded-lg p-4 my-3 italic text-[var(--text-secondary)]">
+            <div class="flex items-center gap-2 mb-2 text-sm font-medium text-[var(--accent)]">
+              <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" />
+              </svg>
+              Thinking
+            </div>
+            <div>${props.thinking}</div>
+          </div>
+        `,
+
+        table: (props) => `
+          <div class="overflow-x-auto my-3">
+            <table class="min-w-full border border-[var(--border-color)] rounded-lg overflow-hidden">
+              ${props.headers ? `
+                <thead class="bg-[var(--bg-secondary)]">
+                  <tr>
+                    ${props.headers.map(h => `<th class="px-4 py-2 text-left font-medium">${h}</th>`).join('')}
+                  </tr>
+                </thead>
+              ` : ''}
+              <tbody>
+                ${(props.rows || []).map((row, i) => `
+                  <tr class="${i % 2 ? 'bg-[var(--bg-secondary)]' : ''}">
+                    ${row.map(cell => `<td class="px-4 py-2 border-t border-[var(--border-color)]">${cell}</td>`).join('')}
+                  </tr>
+                `).join('')}
+              </tbody>
+            </table>
+          </div>
+        `,
+
+        code: (props) => {
+          const highlighted = props.language
+            ? hljs.highlight(props.code, { language: props.language }).value
+            : hljs.highlightAuto(props.code).value;
+          return `
+            <div class="my-3 rounded-lg overflow-hidden border border-[var(--border-color)]">
+              <div class="bg-[var(--bg-secondary)] px-4 py-2 text-xs text-[var(--text-secondary)] flex justify-between items-center">
+                <span>${props.language || 'code'}</span>
+                <button onclick="copyCode(this)" class="hover:text-[var(--accent)]">Copy</button>
+              </div>
+              <pre class="p-4 overflow-x-auto bg-[#0d1117]"><code class="text-sm">${highlighted}</code></pre>
+            </div>
+          `;
+        },
+
+        callout: (props) => `
+          <div class="callout-${props.style || 'info'} border-l-4 rounded-r-lg p-4 my-3">
+            ${props.title ? `<div class="font-semibold mb-1">${props.title}</div>` : ''}
+            <div class="text-sm">${props.callout}</div>
+          </div>
+        `,
+
+        image: (props) => `
+          <div class="my-3">
+            <img src="${props.src}" alt="${props.alt || ''}" class="rounded-lg max-w-full" />
+            ${props.caption ? `<p class="text-sm text-[var(--text-secondary)] mt-2 text-center">${props.caption}</p>` : ''}
+          </div>
+        `,
+
+        button: (props) => `
+          <button
+            onclick="handleComponentAction('${props.action || ''}', ${JSON.stringify(props.payload || {})})"
+            class="inline-flex items-center gap-2 px-4 py-2 rounded-lg bg-[var(--accent)] text-white font-medium hover:opacity-90 my-2"
+          >
+            ${props.label}
+          </button>
+        `
+      };
+
+      // Copy code helper
+      function copyCode(btn) {
+        const code = btn.closest('.rounded-lg').querySelector('code').textContent;
+        navigator.clipboard.writeText(code);
+        btn.textContent = 'Copied!';
+        setTimeout(() => btn.textContent = 'Copy', 2000);
+      }
+
+      // Component action handler (for interactive components)
+      function handleComponentAction(action, payload) {
+        console.log('Component action:', action, payload);
+        // Could send back to server or handle locally
+      }
+
+      // Render a single message
+      function renderMessage(msg) {
+        const wrapper = document.createElement('div');
+        wrapper.className = `rounded-lg p-4 ${msg.role === 'user'
+          ? 'bg-[var(--accent)] text-white ml-12'
+          : 'bg-[var(--bg-secondary)] mr-12'}`;
+
+        if (msg.role === 'user') {
+          wrapper.innerHTML = `<div>${msg.content}</div>`;
+        } else {
+          let html = '';
+          for (const part of msg.parts || [])
+            html += components[part.type]?.(part) || '';
+          wrapper.innerHTML = `<div class="prose prose-invert max-w-none">${html}</div>`;
+        }
+        return wrapper;
+      }
+
+      // Render all messages
+      function render() {
+        const container = document.getElementById('messages');
+        container.innerHTML = '';
+        messages.forEach(msg => container.appendChild(renderMessage(msg)));
+        container.scrollTop = container.scrollHeight;
+      }
+
+      // Stream response from server
+      async function streamResponse(userMessage) {
+        messages.push({ role: 'user', content: userMessage });
+        messages.push({ role: 'assistant', parts: [] });
+        render();
+
+        const response = await fetch('/chat/cycls', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            messages: messages.slice(0, -1).map(m => ({ role: m.role, content: m.content, parts: m.parts }))
+          })
+        });
+
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        let assistantMsg = messages[messages.length - 1];
+        let currentPart = null;
+
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+
+          buffer += decoder.decode(value, { stream: true });
+          const lines = buffer.split('\n');
+          buffer = lines.pop() || '';
+
+          for (const line of lines) {
+            if (!line.startsWith('data: ')) continue;
+            const data = line.slice(6);
+            if (data === '[DONE]') continue;
+
+            try {
+              const item = JSON.parse(data);
+              const type = item.type;
+
+              // Same type as current? Append content
+              if (currentPart && currentPart.type === type) {
+                if (item.row) currentPart.rows.push(item.row);
+                else if (item[type]) currentPart[type] = (currentPart[type] || '') + item[type];
+              } else {
+                // New component
+                currentPart = { ...item };
+                if (item.headers) currentPart.rows = [];
+                assistantMsg.parts.push(currentPart);
+              }
+              render();
+            } catch (e) {
+              console.error('Parse error:', e, data);
+            }
+          }
+        }
+        assistantMsg.parts = assistantMsg.parts.filter(p =>
+          p.type !== 'text' || p.text?.trim()
+        );
+        render();
+        console.log(messages);
+      }
+
+      // Form submit
+      document.getElementById('chat-form').addEventListener('submit', async (e) => {
+        e.preventDefault();
+        const input = document.getElementById('input');
+        const message = input.value.trim();
+        if (!message) return;
+        input.value = '';
+        await streamResponse(message);
+      });
+
+      // Highlight code blocks after render
+      const observer = new MutationObserver(() => {
+        document.querySelectorAll('pre code:not(.hljs)').forEach(el => hljs.highlightElement(el));
+      });
+      observer.observe(document.getElementById('messages'), { childList: true, subtree: true });
+    </script>
+  </body>
+</html>

cycls/web.py

@@ -0,0 +1,171 @@
+import json, inspect
+from pathlib import Path
+from pydantic import BaseModel
+from typing import Optional, Union, Any
+from .auth import PK_LIVE, PK_TEST, JWKS_PROD, JWKS_TEST
+
+class Config(BaseModel):
+    public_path: str = "theme"
+    header: Optional[str] = None
+    intro: Optional[str] = None
+    title: Optional[str] = None
+    prod: bool = False
+    auth: bool = False
+    plan: str = "free"
+    analytics: bool = False
+    org: Optional[str] = None
+    pk: Optional[str] = None
+    jwks: Optional[str] = None
+    state: Union[bool, str] = False
+
+    def set_prod(self, prod: bool):
+        self.prod = prod
+        self.pk = PK_LIVE if prod else PK_TEST
+        self.jwks = JWKS_PROD if prod else JWKS_TEST
+
+async def openai_encoder(stream):
+    if inspect.isasyncgen(stream):
+        async for msg in stream:
+            if msg: yield f"data: {json.dumps({'choices': [{'delta': {'content': msg}}]})}\n\n"
+    else:
+        for msg in stream:
+            if msg: yield f"data: {json.dumps({'choices': [{'delta': {'content': msg}}]})}\n\n"
+    yield "data: [DONE]\n\n"
+
+def sse(item):
+    if not item: return None
+    if not isinstance(item, dict): item = {"type": "text", "text": item}
+    return f"data: {json.dumps(item)}\n\n"
+
+async def encoder(stream):
+    if inspect.isasyncgen(stream):
+        async for item in stream:
+            if msg := sse(item): yield msg
+    else:
+        for item in stream:
+            if msg := sse(item): yield msg
+    yield "data: [DONE]\n\n"
+
+class Messages(list):
+    """A list that provides text-only messages by default, with .raw for full data."""
+    def __init__(self, raw_messages):
+        self._raw = raw_messages
+        text_messages = []
+        for m in raw_messages:
+            text_content = "".join(
+                p.get("text", "") for p in m.get("parts", []) if p.get("type") == "text"
+            )
+            text_messages.append({
+                "role": m.get("role"),
+                "content": m.get("content") or text_content
+            })
+        super().__init__(text_messages)
+
+    @property
+    def raw(self):
+        return self._raw
+
+def web(func, config):
+    from fastapi import FastAPI, Request, HTTPException, status, Depends
+    from fastapi.responses import StreamingResponse
+    from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials
+    import jwt
+    from jwt import PyJWKClient
+    from pydantic import EmailStr
+    from typing import List, Optional, Any
+    from fastapi.staticfiles import StaticFiles
+
+    if isinstance(config, dict):
+        config = Config(**config)
+
+    jwks = PyJWKClient(config.jwks)
+
+    class User(BaseModel):
+        id: str
+        name: Optional[str] = None
+        email: EmailStr
+        org: Optional[str] = None
+        plans: List[str] = []
+
+    class Context(BaseModel):
+        messages: Any
+        user: Optional[User] = None
+        state: Optional[Any] = None
+
+        model_config = {"arbitrary_types_allowed": True}
+
+        @property
+        def last_message(self) -> str:
+            if self.messages:
+                return self.messages[-1].get("content", "")
+            return ""
+
+        @property
+        def kv(self):
+            return self.state.kv if self.state else None
+
+        @property
+        def fs(self):
+            return self.state.fs if self.state else None
+
+    app = FastAPI()
+    bearer_scheme = HTTPBearer()
+
+    def validate(bearer: HTTPAuthorizationCredentials = Depends(bearer_scheme)):
+        try:
+            key = jwks.get_signing_key_from_jwt(bearer.credentials)
+            decoded = jwt.decode(bearer.credentials, key.key, algorithms=["RS256"], leeway=10)
+            return {"type": "user",
+                    "user": {"id": decoded.get("id"), "name": decoded.get("name"), "email": decoded.get("email"), "org": decoded.get("org"),
+                             "plans": decoded.get("public", {}).get("plans", [])}}
+        except jwt.ExpiredSignatureError:
+            raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Token expired", headers={"WWW-Authenticate": "Bearer"})
+        except jwt.InvalidTokenError as e:
+            raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail=f"Invalid token: {e}", headers={"WWW-Authenticate": "Bearer"})
+        except Exception as e:
+            raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail=f"Auth error: {e}", headers={"WWW-Authenticate": "Bearer"})
+    
+    @app.post("/")
+    @app.post("/chat/cycls")
+    @app.post("/chat/completions")
+    async def back(request: Request, jwt: Optional[dict] = Depends(validate) if config.auth else None):
+        data = await request.json()
+        messages = data.get("messages")
+        user_data = jwt.get("user") if jwt else None
+        user = User(**user_data) if user_data else None
+
+        # Initialize state scoped to user
+        state_instance = None
+        if config.state:
+            from .state import create_state
+            user_id = user.id if user else "anonymous"
+            state_instance = await create_state(user_id)
+
+        context = Context(messages=Messages(messages), user=user, state=state_instance)
+        stream = await func(context) if inspect.iscoroutinefunction(func) else func(context)
+
+        if request.url.path == "/chat/completions":
+            stream = openai_encoder(stream)
+        elif request.url.path == "/chat/cycls":
+            stream = encoder(stream)
+        return StreamingResponse(stream, media_type="text/event-stream")
+
+    @app.get("/config")
+    async def get_config():
+        return config
+
+    if Path("public").is_dir():
+        app.mount("/public", StaticFiles(directory="public", html=True))
+    app.mount("/", StaticFiles(directory=config.public_path, html=True))
+
+    return app
+
+def serve(func, config, name, port):
+    import uvicorn, logging
+    from dotenv import load_dotenv
+    load_dotenv()
+    if isinstance(config, dict):
+        config = Config(**config)
+    logging.getLogger("uvicorn.error").addFilter(lambda r: "0.0.0.0" not in r.getMessage())
+    print(f"\n🔨 {name} => http://localhost:{port}\n")
+    uvicorn.run(web(func, config), host="0.0.0.0", port=port)