xenfra-sdk 0.2.2__py3-none-any.whl → 0.2.4__py3-none-any.whl

xenfra_sdk/templates/cloud-init.sh.j2

@@ -1,90 +1,90 @@
-#!/bin/bash
-export DEBIAN_FRONTEND=noninteractive
-LOG="/root/setup.log"
-touch $LOG
-
-echo "--------------------------------" >> $LOG
-echo "🧘 XENFRA: Context-Aware Boot" >> $LOG
-echo "--------------------------------" >> $LOG
-
-# Create App Directory
-mkdir -p /root/app
-cd /root/app
-
-# --- MERCILESS FIX: TERMINATE BACKGROUND PROCESSES ---
-echo "⚔️  [0/6] Mercilessly Terminating Background Processes..." >> $LOG
-
-kill_apt_processes() {
-  echo "🎯 Killing processes holding apt/dpkg locks..." >> $LOG
-  fuser -k /var/lib/dpkg/lock >/dev/null 2>&1
-  fuser -k /var/lib/apt/lists/lock >/dev/null 2>&1
-  fuser -k /var/lib/dpkg/lock-frontends >/dev/null 2>&1
-}
-
-# Explicitly stop and disable services that cause locks
-systemctl stop unattended-upgrades.service || true
-systemctl disable unattended-upgrades.service || true
-systemctl stop apt-daily.service || true
-systemctl disable apt-daily.service || true
-systemctl stop apt-daily-upgrade.service || true
-systemctl disable apt-daily-upgrade.service || true
-
-# Forcefully kill any remaining lock holders
-kill_apt_processes
-
-# Force remove locks if they still exist (The Nuclear Option)
-rm -f /var/lib/dpkg/lock*
-rm -f /var/lib/apt/lists/lock*
-rm -f /var/cache/apt/archives/lock
-dpkg --configure -a || true
-# -----------------------------------------------
-
-# 1. System Updates
-echo "🔄 [1/5] Refreshing Package Lists..." >> $LOG
-apt-get update
-apt-get install -y python3-pip git curl
-
-# 2. Setup Environment
-{% if is_dockerized %}
-echo "🐳 [2/5] Installing Docker..." >> $LOG
-apt-get install -y docker.io || (curl -fsSL https://get.docker.com | sh)
-echo "🎶 [3/5] Installing Docker Compose..." >> $LOG
-apt-get install -y docker-compose-v2
-{% else %}
-echo "🐍 [2/5] Setting up host-based Python environment..." >> $LOG
-apt-get install -y python3-venv python3-dev build-essential
-{% endif %}
-
-# 3. Setup Reverse Proxy
-{% if is_dockerized %}
-echo "📦 [3/5] Installing Caddy..." >> $LOG
-apt-get install -y debian-keyring debian-archive-keyring apt-transport-https
-curl -LsSf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
-curl -LsSf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | tee /etc/apt/sources.list.d/caddy-stable.list
-apt-get update
-apt-get install -y caddy
-{% else %}
-echo "🛡️ [3/5] Skipping Caddy for host deployment (setup manual reverse proxy if needed)." >> $LOG
-{% endif %}
-
-{% if domain %}
-# Dynamically generate Caddyfile content
-echo "🔒 Writing Caddyfile for {{ domain }}..." >> $LOG
-cat << EOF > /etc/caddy/Caddyfile
-{{ domain }}:80, {{ domain }}:443 {
-    reverse_proxy localhost:{{ port | default(8000) }}
-    tls {{ email }}
-}
-EOF
-{% endif %}
-
-{% if domain %}
-echo "🚀 [5/5] Starting Caddy..." >> $LOG
-systemctl restart caddy
-{% else %}
-echo "✅ [5/5] Skipping Caddy start (no domain specified)." >> $LOG
-{% endif %}
-
-# Finish
-echo "✅ SETUP SCRIPT COMPLETE" >> $LOG
-touch /root/setup_complete
+#!/bin/bash
+export DEBIAN_FRONTEND=noninteractive
+LOG="/root/setup.log"
+touch $LOG
+
+echo "--------------------------------" >> $LOG
+echo "🧘 XENFRA: Context-Aware Boot" >> $LOG
+echo "--------------------------------" >> $LOG
+
+# Create App Directory
+mkdir -p /root/app
+cd /root/app
+
+# --- MERCILESS FIX: TERMINATE BACKGROUND PROCESSES ---
+echo "⚔️  [0/6] Mercilessly Terminating Background Processes..." >> $LOG
+
+kill_apt_processes() {
+  echo "🎯 Killing processes holding apt/dpkg locks..." >> $LOG
+  fuser -k /var/lib/dpkg/lock >/dev/null 2>&1
+  fuser -k /var/lib/apt/lists/lock >/dev/null 2>&1
+  fuser -k /var/lib/dpkg/lock-frontends >/dev/null 2>&1
+}
+
+# Explicitly stop and disable services that cause locks
+systemctl stop unattended-upgrades.service || true
+systemctl disable unattended-upgrades.service || true
+systemctl stop apt-daily.service || true
+systemctl disable apt-daily.service || true
+systemctl stop apt-daily-upgrade.service || true
+systemctl disable apt-daily-upgrade.service || true
+
+# Forcefully kill any remaining lock holders
+kill_apt_processes
+
+# Force remove locks if they still exist (The Nuclear Option)
+rm -f /var/lib/dpkg/lock*
+rm -f /var/lib/apt/lists/lock*
+rm -f /var/cache/apt/archives/lock
+dpkg --configure -a || true
+# -----------------------------------------------
+
+# 1. System Updates
+echo "🔄 [1/5] Refreshing Package Lists..." >> $LOG
+apt-get update
+apt-get install -y python3-pip git curl
+
+# 2. Setup Environment
+{% if is_dockerized %}
+echo "🐳 [2/5] Installing Docker..." >> $LOG
+apt-get install -y docker.io || (curl -fsSL https://get.docker.com | sh)
+echo "🎶 [3/5] Installing Docker Compose..." >> $LOG
+apt-get install -y docker-compose-v2
+{% else %}
+echo "🐍 [2/5] Setting up host-based Python environment..." >> $LOG
+apt-get install -y python3-venv python3-dev build-essential
+{% endif %}
+
+# 3. Setup Reverse Proxy
+{% if is_dockerized or install_caddy %}
+echo "📦 [3/5] Installing Caddy..." >> $LOG
+apt-get install -y debian-keyring debian-archive-keyring apt-transport-https
+curl -LsSf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
+curl -LsSf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | tee /etc/apt/sources.list.d/caddy-stable.list
+apt-get update
+apt-get install -y caddy
+{% else %}
+echo "🛡️ [3/5] Skipping Caddy for host deployment (setup manual reverse proxy if needed)." >> $LOG
+{% endif %}
+
+{% if domain %}
+# Dynamically generate Caddyfile content
+echo "🔒 Writing Caddyfile for {{ domain }}..." >> $LOG
+cat << EOF > /etc/caddy/Caddyfile
+{{ domain }}:80, {{ domain }}:443 {
+    reverse_proxy localhost:{{ port | default(8000) }}
+    tls {{ email }}
+}
+EOF
+{% endif %}
+
+{% if domain %}
+echo "🚀 [5/5] Starting Caddy..." >> $LOG
+systemctl restart caddy
+{% else %}
+echo "✅ [5/5] Skipping Caddy start (no domain specified)." >> $LOG
+{% endif %}
+
+# Finish
+echo "✅ SETUP SCRIPT COMPLETE" >> $LOG
+touch /root/setup_complete

xenfra_sdk/templates/docker-compose-multi.yml.j2

@@ -0,0 +1,29 @@
+# docker-compose.yml template for multi-service deployments
+# Generated by Xenfra for microservices
+
+services:
+{% for service in services %}
+  {{ service.name }}:
+    build: {{ service.path }}
+    ports:
+      - "{{ service.port }}:{{ service.port }}"
+{% if service.command %}
+    command: {{ service.command }}
+{% elif service.entrypoint %}
+{% if service.framework == 'fastapi' %}
+    command: uvicorn {{ service.entrypoint }} --host 0.0.0.0 --port {{ service.port }}
+{% elif service.framework == 'flask' %}
+    command: gunicorn {{ service.entrypoint }} -b 0.0.0.0:{{ service.port }}
+{% elif service.framework == 'django' %}
+    command: gunicorn {{ service.entrypoint }} --bind 0.0.0.0:{{ service.port }}
+{% endif %}
+{% endif %}
+{% if service.env %}
+    environment:
+{% for key, value in service.env.items() %}
+      - {{ key }}={{ value }}
+{% endfor %}
+{% endif %}
+    restart: unless-stopped
+
+{% endfor %}

xenfra_sdk/templates/docker-compose.yml.j2

@@ -1,30 +1,30 @@
-# docker-compose.yml template
-
-services:
-  app:
-    build: .
-    ports:
-      - "{{ port | default(8000) }}:{{ port | default(8000) }}"
-{% if command and command != 'None' %}
-    command: {{ command }}
-{% else %}
-    command: ["uvicorn", "{{ entrypoint | default('src.main:app') }}", "--host", "0.0.0.0", "--port", "{{ port | default(8000) }}"]
-{% endif %}
-{% if database == 'postgres' or database == 'postgresql' %}
-    depends_on:
-      - db
-    environment:
-      - DATABASE_URL=postgresql://{{ db_user | default('user') }}:{{ db_password | default('password') }}@db:5432/{{ db_name | default('appdb') }}
-
-  db:
-    image: postgres:15-alpine
-    volumes:
-      - postgres_data:/var/lib/postgresql/data/
-    environment:
-      - POSTGRES_USER={{ db_user | default('user') }}
-      - POSTGRES_PASSWORD={{ db_password | default('password') }}
-      - POSTGRES_DB={{ db_name | default('appdb') }}
-
-volumes:
-  postgres_data:
-{% endif %}
+# docker-compose.yml template
+
+services:
+  app:
+    build: .
+    ports:
+      - "{{ port | default(8000) }}:{{ port | default(8000) }}"
+{% if command and command != 'None' %}
+    command: {{ command }}
+{% else %}
+    command: ["uvicorn", "{{ entrypoint | default('src.main:app') }}", "--host", "0.0.0.0", "--port", "{{ port | default(8000) }}"]
+{% endif %}
+{% if database == 'postgres' or database == 'postgresql' %}
+    depends_on:
+      - db
+    environment:
+      - DATABASE_URL=postgresql://{{ db_user | default('user') }}:{{ db_password | default('password') }}@db:5432/{{ db_name | default('appdb') }}
+
+  db:
+    image: postgres:15-alpine
+    volumes:
+      - postgres_data:/var/lib/postgresql/data/
+    environment:
+      - POSTGRES_USER={{ db_user | default('user') }}
+      - POSTGRES_PASSWORD={{ db_password | default('password') }}
+      - POSTGRES_DB={{ db_name | default('appdb') }}
+
+volumes:
+  postgres_data:
+{% endif %}

xenfra_sdk-0.2.4.dist-info/METADATA

@@ -0,0 +1,116 @@
+Metadata-Version: 2.3
+Name: xenfra-sdk
+Version: 0.2.4
+Summary: Xenfra SDK: Core engine and utilities for the Xenfra platform.
+Author: xenfra-cloud
+Author-email: xenfra-cloud <xenfracloud@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Systems Administration
+Requires-Dist: fabric>=3.2.2
+Requires-Dist: python-digitalocean>=1.17.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: sqlmodel>=0.0.16
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: jinja2>=3.1.3
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: passlib>=1.7.4
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: pytest>=8.0.0 ; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12.0 ; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0 ; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0 ; extra == 'dev'
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/xenfra-cloud/xenfra-sdk
+Project-URL: Issues, https://github.com/xenfra-cloud/xenfra-sdk/issues
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# Xenfra SDK (The Engine) 📦
+
+[![PyPI](https://img.shields.io/pypi/v/xenfra-sdk)](https://pypi.org/project/xenfra-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/pypi/pyversions/xenfra-sdk.svg)](https://pypi.org/project/xenfra-sdk/)
+
+The core infrastructure automation engine behind **Xenfra** (The Sovereign Cloud OS). This SDK provides the primitives for deploying, managing, and diagnosing applications on DigitalOcean with "Zen Mode" auto-healing.
+
+## 🚀 Features
+
+- **InfraEngine**: A robust 9-phase deployment pipeline (Setup -> Asset Gen -> Droplet -> Code -> Build -> Health).
+- **Dockerizer**: Deterministic Dockerfile and Compose generation using Jinja2 templates.
+- **Zen Mode**: Utilities to automatically heal common failures (e.g., locked dpkg, exhausted ports).
+- **Privacy-First**: Built-in PII scrubbing for logs before they touch any AI services.
+- **Security**: Fernet encryption for tokens and RS256 JWT validation helpers.
+
+## 📦 Installation
+
+```bash
+pip install xenfra-sdk
+# or with uv
+uv add xenfra-sdk
+```
+
+## 🛠️ Usage
+
+### 1. Initialize the Engine
+
+```python
+from xenfra_sdk import XenfraClient, InfraEngine
+
+# Authenticate (Token usually comes from the CLI)
+client = XenfraClient(token="xenfra_...")
+engine = InfraEngine(client)
+```
+
+### 2. Deploy a Project
+
+```python
+project_path = "/path/to/my-fastapi-app"
+
+# The engine handles detection (Python/Node), dockerization, and provisioning
+deployment = await engine.deploy(
+    path=project_path,
+    project_id="proj_123",
+    env_vars={"DATABASE_URL": "..."}
+)
+
+print(f"🚀 Deployed successfully to: http://{deployment.ip_address}")
+```
+
+### 3. Diagnose a Failure
+
+```python
+from xenfra_sdk.intelligence import diagnose_failure
+
+logs = client.deployments.get_logs(deployment.id)
+analysis = await diagnose_failure(logs)
+
+print(f"Diagnosis: {analysis.root_cause}")
+print(f"Suggested Fix: {analysis.suggestion}")
+```
+
+## 🔗 The Xenfra Ecosystem
+
+This SDK is the "Body" of the Xenfra Open Core architecture:
+
+- **[xenfra-cli](https://github.com/xenfracloud/xenfra-cli)**: The Terminal Interface (Uses this SDK).
+- **[xenfra-mcp](https://github.com/xenfracloud/xenfra-mcp)**: The AI Agent Interface (Uses this SDK).
+- **xenfra-platform**: The Private SaaS Backend (Uses this SDK).
+
+## 🤝 Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+1.  Clone: `git clone https://github.com/xenfracloud/xenfra-sdk`
+2.  Install: `uv sync`
+3.  Test: `pytest`
+
+## 📄 License
+
+MIT © [Xenfra Cloud](https://xenfra.tech)

xenfra_sdk-0.2.4.dist-info/RECORD

@@ -0,0 +1,38 @@
+xenfra_sdk/__init__.py,sha256=ZPdW5mFBa9UbmJXRjyBeodbIHWCQsOvmJ2MmUn0aApY,1420
+xenfra_sdk/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xenfra_sdk/cli/main.py,sha256=541nlIUYFFeu4h1sCXivaHMC7SqpskazI0YocM8ylh4,7958
+xenfra_sdk/client.py,sha256=88M-ram8wDVfVEPpa3q1z4hXToBg4kSOgsIBOLXxsBo,3597
+xenfra_sdk/client_with_hooks.py,sha256=iN-xTGdeSPizktM6UG-aZEsuwQc5OgosNYUf1_Tq4Dc,10046
+xenfra_sdk/config.py,sha256=gaT4k5iJgW9guNVmlnYkCFGDSU1_er4LRZA2CgfKmJ0,588
+xenfra_sdk/db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xenfra_sdk/db/models.py,sha256=ysAvkbVuLdOjhD2iA-oJ1xggPrNBsUNLY3Cfm-FFJ_Q,682
+xenfra_sdk/db/session.py,sha256=0MA0404QU9eUabDgTqi-wNIUP0DpIKKG-OvB4Jzf7rc,885
+xenfra_sdk/dependencies.py,sha256=WHGfIrEYkss5yuBd_uOFrB6lPBWM2X0mEuG26ILAjXI,1211
+xenfra_sdk/detection.py,sha256=t8FA_AaNphvv-G0dGL6hLYqOdC9an6-QnVrtFoiTd7M,13993
+xenfra_sdk/dockerizer.py,sha256=KuVGcS5RacR91fGo_6pPlQ4wvJYqnenz0C6x9JoLPWU,7291
+xenfra_sdk/engine.py,sha256=1APOo3DWQBeZscYs9Ay6BdYrp0VzialZiz06L3X4gng,35710
+xenfra_sdk/exceptions.py,sha256=aMVtDVlzG7-FT2G_b-pJSuuey22B4YvC-b-L37GaImM,477
+xenfra_sdk/manifest.py,sha256=49wfCr0VK9AJBCF8HGOJ_K0ru8iUbjRDczH3MPzPJBc,6613
+xenfra_sdk/mcp_client.py,sha256=NZtQz_qK_8i504rVPXlE1vPdzt75hg8Lkp4d8BA8dk0,5777
+xenfra_sdk/models.py,sha256=qSUvtsBMaiTKCHxOcdgY9ghJc-rwwZEOHMp1qiTuvMI,7198
+xenfra_sdk/orchestrator.py,sha256=vRRBC9dl8A8HwQ7gHGwzC31MeZ7aXvyqhfjK4t4Yvno,27211
+xenfra_sdk/patterns.json,sha256=xHxbc0ogHDwysMczi30_hW1Ylfdsf-nsQdAom7RZ4KI,446
+xenfra_sdk/privacy.py,sha256=Bscv7bopCQTeJhvU8Z2jxdBfc5tCZDY5kuODonTcgSk,5509
+xenfra_sdk/recipes.py,sha256=-LLMz1ye6sqHb9zg3YGhOXzYO6-S9I13xTEKhca7C5U,947
+xenfra_sdk/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xenfra_sdk/resources/base.py,sha256=5n-HTKAnIX2lTgXwio0xtwoaBn-nksjdm8qRTpe3iDk,81
+xenfra_sdk/resources/deployments.py,sha256=kqSxxAwJx_3TveNH-075RQH9IbQ9w-qJ9uM29CETuJU,11941
+xenfra_sdk/resources/files.py,sha256=opdxZt6GWMU-qu5ltfWfv2hm8TscdaK-r9o4k743Irs,3087
+xenfra_sdk/resources/intelligence.py,sha256=_jCIqny-gTV5cBjC6RF5CAs86xzXUKuoqNSAtkNnIYY,3560
+xenfra_sdk/resources/projects.py,sha256=EsCVXmqkhWl_Guz_8WDQDi3kAm1Wyg1rjXcyAigPD6E,3712
+xenfra_sdk/security.py,sha256=6vMZpbglhkRGBVVj4RCTu45-MCnQ15wt94-996zmaT8,1199
+xenfra_sdk/security_scanner.py,sha256=US9QdMjHdTUkqObrGPHvDPxMP0QXCxmwK5e28d8KT2E,12957
+xenfra_sdk/templates/Caddyfile.j2,sha256=PVXffF6dQN06xZ5KyiaSBTK31742v3GN4ISSwiJAXC4,320
+xenfra_sdk/templates/Dockerfile.j2,sha256=qEMnFo2kfYNWaeTpyjh6qeKciHv0dBBNxSVRmnmAIQQ,1176
+xenfra_sdk/templates/cloud-init.sh.j2,sha256=xOwf-VERYXnL8vNMU13SnrmRX0H-hEh3l1A4zSmLG0c,2999
+xenfra_sdk/templates/docker-compose-multi.yml.j2,sha256=PWSPdWsGb-sWJ-XCutMdHiz-uhChIwEN6QMaZ0_Spxs,911
+xenfra_sdk/templates/docker-compose.yml.j2,sha256=TQ__p3-TYAUbU0RNeZCxTjJ9gt81-Rry1B1QnuPzBzc,935
+xenfra_sdk/utils.py,sha256=d8eCjjV32QwqoJa759CEcETnnsjG5qVKDLQ84yYtlus,3898
+xenfra_sdk-0.2.4.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+xenfra_sdk-0.2.4.dist-info/METADATA,sha256=-YUayzDL4AnUeQI4lXbfjx_l5_P4Psd62qfeglVCxr4,3982
+xenfra_sdk-0.2.4.dist-info/RECORD,,

xenfra_sdk-0.2.2.dist-info/METADATA

@@ -1,118 +0,0 @@
-Metadata-Version: 2.3
-Name: xenfra-sdk
-Version: 0.2.2
-Summary: Xenfra SDK: Core engine and utilities for the Xenfra platform.
-Author: xenfra-cloud
-Author-email: xenfra-cloud <xenfracloud@gmail.com>
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: System :: Systems Administration
-Requires-Dist: fabric>=3.2.2
-Requires-Dist: python-digitalocean>=1.17.0
-Requires-Dist: python-dotenv>=1.2.1
-Requires-Dist: rich>=14.2.0
-Requires-Dist: sqlmodel>=0.0.16
-Requires-Dist: pyyaml>=6.0.1
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: jinja2>=3.1.3
-Requires-Dist: python-jose[cryptography]>=3.3.0
-Requires-Dist: passlib>=1.7.4
-Requires-Dist: cryptography>=41.0.0
-Requires-Python: >=3.13
-Description-Content-Type: text/markdown
-
-# Xenfra Python SDK
-
-The official, open-source Python SDK for interacting with the Xenfra API.
-
-This SDK provides a simple and Pythonic interface for developers and AI Agents to programmatically manage infrastructure, deployments, and other platform resources.
-
-## Installation
-
-```bash
-pip install xenfra-sdk
-```
-
-## Basic Usage
-
-Initialize the client with your API token (or ensure the `XENFRA_TOKEN` environment variable is set).
-
-```python
-import os
-from xenfra_sdk import XenfraClient
-from xenfra_sdk.exceptions import XenfraAPIError
-
-client = XenfraClient(token=os.getenv("XENFRA_TOKEN"))
-
-try:
-    projects = client.projects.list()
-    for p in projects:
-        print(f"Found project: {p.name} (Status: {p.status})")
-except XenfraAPIError as e:
-    print(f"API Error: {e.detail}")
-```
-
-## Usage for Agentic Workflows
-
-The Xenfra SDK is designed to be used as a "tool" by AI Agents (e.g., OpenAI Assistants). The Pydantic models are compatible with function-calling schemas, allowing an agent to easily call these methods.
-
-Here is a conceptual example of how an agent might use the SDK to fulfill a user's request.
-
-```python
-# This is a conceptual representation of an agent's internal logic.
-# The agent would be configured with functions that call these SDK methods.
-
-def list_all_projects():
-    """Lists all available projects in the Xenfra account."""
-    return client.projects.list()
-
-def create_new_deployment(project_name: str, git_repo: str, branch: str = "main"):
-    """
-    Creates a new deployment for a project.
-    
-    Args:
-        project_name: The name for the new deployment.
-        git_repo: The URL of the git repository to deploy.
-        branch: The branch to deploy (defaults to 'main').
-    """
-    return client.deployments.create(
-        project_name=project_name,
-        git_repo=git_repo,
-        branch=branch,
-        framework="fastapi" # Framework detection would be part of a more complex agent
-    )
-
-# --- Agent Execution Flow ---
-
-# User prompt: "Deploy my new app from github.com/user/my-app"
-
-# 1. Agent decides which tool to use: `create_new_deployment`
-# 2. Agent extracts parameters:
-#    - project_name = "my-app" (inferred)
-#    - git_repo = "https://github.com/user/my-app"
-# 3. Agent calls the tool:
-#    create_new_deployment(
-#        project_name="my-app",
-#        git_repo="https://github.com/user/my-app"
-#    )
-```
-
-## Error Handling
-
-The SDK uses custom exceptions for clear error handling. All API-related errors will raise a `XenfraAPIError`, which contains the `status_code` and a `detail` message from the API response.
-
-```python
-from xenfra_sdk.exceptions import XenfraAPIError, AuthenticationError
-
-try:
-    # Make an API call
-    ...
-except AuthenticationError as e:
-    print("Authentication failed. Please check your token.")
-except XenfraAPIError as e:
-    print(f"An API error occurred with status {e.status_code}: {e.detail}")
-```

xenfra_sdk-0.2.2.dist-info/RECORD

@@ -1,32 +0,0 @@
-xenfra_sdk/__init__.py,sha256=ILBGPKNWJjEwvLWxYD2ulOYLD43nf3-Xu71FwcraH5c,488
-xenfra_sdk/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xenfra_sdk/cli/main.py,sha256=9uQja07LxLfBCHeCRlDCStK1X248h9kMRPep6iFShyk,8184
-xenfra_sdk/client.py,sha256=QrielXkhYw4CBw3Qr7VA91279BMsS0SLUAMGRecpTa8,3687
-xenfra_sdk/client_with_hooks.py,sha256=iN-xTGdeSPizktM6UG-aZEsuwQc5OgosNYUf1_Tq4Dc,10046
-xenfra_sdk/config.py,sha256=omb3SQMAk5NXOuCrLZe4bp_bX7F0SXA1ERJ5PdDaxMU,614
-xenfra_sdk/db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xenfra_sdk/db/models.py,sha256=oNT9UhYzr_SgzDJdPu5fF6IiiztWjm2tHZzpIAYVJ4Y,706
-xenfra_sdk/db/session.py,sha256=ul6tFBBDKU8UErJsZ-g7b8cryLr9-yA6jGY3d8fD15Q,853
-xenfra_sdk/dependencies.py,sha256=k7tiy_5dayr_iQx_i2klGeNjGWhxfivGVC38SpvQvzE,1250
-xenfra_sdk/dockerizer.py,sha256=E-8oqmaS-Cb06B8lRj3iZpby43ObqhUMQU_5msAdYRM,7428
-xenfra_sdk/engine.py,sha256=gFiARsp9FcUuCULfmnbA9jkIL3u3sLVn_dWA0zt4hSc,30096
-xenfra_sdk/exceptions.py,sha256=FaKctVJNMFIw09G8Lm2yd_DHhSngGcyh2j_BTgXMM60,496
-xenfra_sdk/mcp_client.py,sha256=GPsVJtWT87G7k_GxePATLfCqFkYFFNIbpW5AsZi4Bhk,5931
-xenfra_sdk/models.py,sha256=2Zrvi7EWAzpw1ArcYa8HmF3WjuRhzYCYpK8XyMh2XE4,7382
-xenfra_sdk/patterns.json,sha256=RBuQdU59UEXF5pxUvcWq_ZegsK0iUfh4wusWaY77qxo,459
-xenfra_sdk/privacy.py,sha256=ksGf5L9PVtRP-xZS3T-Gj7MKfexTqIMgbFLoYkIESOE,5662
-xenfra_sdk/recipes.py,sha256=jSFlPLIze3rKpBaeFKNVkWESQzBXWGkoSwSH1jwx0Vs,973
-xenfra_sdk/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xenfra_sdk/resources/base.py,sha256=C6BuZfhR-oU5ecHSfkGG6ZLU6MHGXUyCWoy1F-yTIf8,84
-xenfra_sdk/resources/deployments.py,sha256=AUNixKvyW4imq4W2iKeXcbxQUW82SrUeY8ZG4rr6HLI,10549
-xenfra_sdk/resources/files.py,sha256=t6jVvzN71J_soPj7MphzRaYxGeJ0X9H98nTY8euEfR8,3188
-xenfra_sdk/resources/intelligence.py,sha256=Y11K6_iXfm2QKTbH1vUmt45MifLoVtZtlHEkqbzmTzs,3418
-xenfra_sdk/resources/projects.py,sha256=EsCVXmqkhWl_Guz_8WDQDi3kAm1Wyg1rjXcyAigPD6E,3712
-xenfra_sdk/security.py,sha256=Px887RRb1BUDXaPUrxmQITJ1mHyOyupCJqEDZ78F7Tk,1240
-xenfra_sdk/templates/Dockerfile.j2,sha256=XDZv_93Yzk_qn9QF6g-uo2TaFphiwoj9JbANvBSZ0BE,1178
-xenfra_sdk/templates/cloud-init.sh.j2,sha256=fxQP2GVAAVVvDAqlOVH3eNmeKSTFQ2soErQQRD5RX3U,3072
-xenfra_sdk/templates/docker-compose.yml.j2,sha256=rJ6Z2UwHwu-FN137WrY29mbOK1yYBtTXq89xRolB_zw,965
-xenfra_sdk/utils.py,sha256=d8eCjjV32QwqoJa759CEcETnnsjG5qVKDLQ84yYtlus,3898
-xenfra_sdk-0.2.2.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
-xenfra_sdk-0.2.2.dist-info/METADATA,sha256=BqHTZBO_b9zPMXLrb4brk_kcSFI91EOzNgmMlx2xrnw,3980
-xenfra_sdk-0.2.2.dist-info/RECORD,,