agent-framework-lib 0.8.11__tar.gz → 0.8.12__tar.gz

{agent_framework_lib-0.8.11/agent_framework_lib.egg-info → agent_framework_lib-0.8.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-framework-lib
-Version: 0.8.11
+Version: 0.8.12
 Summary: A comprehensive Python framework for building and serving conversational AI agents with FastAPI
 Author-email: Sebastian Pavel <sebastian@cinco.ai>, Elliott Girard <elliott.girard@icloud.com>
 Maintainer-email: Sebastian Pavel <sebastian@cinco.ai>
@@ -325,6 +325,17 @@ HELPER_AGENT_MODEL=gpt-5.4
 - "How do I configure S3 storage?"
 - "Search the web for LlamaIndex best practices"
 
+## 📦 Image de runtime des agents
+
+Pour **déployer** un agent, partez de l'image officielle — Chromium Playwright, Deno, git, root,
+sandbox locale déjà en place (sinon l'agent ne peut ni rendre un PNG ni installer quoi que ce soit) :
+
+```dockerfile
+FROM ghcr.io/komus-ai/agent-framework-runtime:0.8.12
+```
+
+Détails, publication et visibilité GHCR : [docs/AGENT_RUNTIME_IMAGE.md](docs/AGENT_RUNTIME_IMAGE.md).
+
 ## 🐳 Docker Development Environment
 
 For local development, use Docker Compose to run all external services (Elasticsearch, MongoDB, PostgreSQL, FalkorDB, MinIO):

{agent_framework_lib-0.8.11/agent_framework/web/docs → agent_framework_lib-0.8.12}/README.md

@@ -167,6 +167,17 @@ HELPER_AGENT_MODEL=gpt-5.4
 - "How do I configure S3 storage?"
 - "Search the web for LlamaIndex best practices"
 
+## 📦 Image de runtime des agents
+
+Pour **déployer** un agent, partez de l'image officielle — Chromium Playwright, Deno, git, root,
+sandbox locale déjà en place (sinon l'agent ne peut ni rendre un PNG ni installer quoi que ce soit) :
+
+```dockerfile
+FROM ghcr.io/komus-ai/agent-framework-runtime:0.8.12
+```
+
+Détails, publication et visibilité GHCR : [docs/AGENT_RUNTIME_IMAGE.md](docs/AGENT_RUNTIME_IMAGE.md).
+
 ## 🐳 Docker Development Environment
 
 For local development, use Docker Compose to run all external services (Elasticsearch, MongoDB, PostgreSQL, FalkorDB, MinIO):

agent_framework_lib-0.8.12/agent_framework/web/docs/Dockerfile

@@ -0,0 +1,19 @@
+# Exemple : déployer un agent basé sur agent-framework-lib.
+# Base = image de runtime officielle (Chromium Playwright, Deno, git, root, sandbox locale) :
+# voir docs/AGENT_RUNTIME_IMAGE.md. Ne repartez PAS de python:*-slim à la main : vous
+# retomberiez sur une sandbox sans libs Chromium ni droits (export PNG impossible).
+FROM ghcr.io/komus-ai/agent-framework-runtime:0.8.12
+
+WORKDIR /app
+
+# Deps figées par uv.lock (pas de résolution à neuf au build).
+COPY pyproject.toml uv.lock ./
+RUN uv export --frozen --no-dev --no-emit-project --no-hashes -o /tmp/requirements.txt \
+ && uv pip install --system -r /tmp/requirements.txt
+
+# Code de l'agent.
+COPY src ./src
+RUN uv pip install --system --no-deps .
+
+# Contrat Mozart : 0.0.0.0:8000 + GET /health (healthcheck déjà défini dans l'image de base).
+CMD ["python", "-m", "your_agent.main"]

{agent_framework_lib-0.8.11 → agent_framework_lib-0.8.12/agent_framework_lib.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-framework-lib
-Version: 0.8.11
+Version: 0.8.12
 Summary: A comprehensive Python framework for building and serving conversational AI agents with FastAPI
 Author-email: Sebastian Pavel <sebastian@cinco.ai>, Elliott Girard <elliott.girard@icloud.com>
 Maintainer-email: Sebastian Pavel <sebastian@cinco.ai>
@@ -325,6 +325,17 @@ HELPER_AGENT_MODEL=gpt-5.4
 - "How do I configure S3 storage?"
 - "Search the web for LlamaIndex best practices"
 
+## 📦 Image de runtime des agents
+
+Pour **déployer** un agent, partez de l'image officielle — Chromium Playwright, Deno, git, root,
+sandbox locale déjà en place (sinon l'agent ne peut ni rendre un PNG ni installer quoi que ce soit) :
+
+```dockerfile
+FROM ghcr.io/komus-ai/agent-framework-runtime:0.8.12
+```
+
+Détails, publication et visibilité GHCR : [docs/AGENT_RUNTIME_IMAGE.md](docs/AGENT_RUNTIME_IMAGE.md).
+
 ## 🐳 Docker Development Environment
 
 For local development, use Docker Compose to run all external services (Elasticsearch, MongoDB, PostgreSQL, FalkorDB, MinIO):

{agent_framework_lib-0.8.11 → agent_framework_lib-0.8.12}/agent_framework_lib.egg-info/SOURCES.txt

@@ -292,6 +292,7 @@ agent_framework_lib.egg-info/requires.txt
 agent_framework_lib.egg-info/top_level.txt
 docs/A2A_GUIDE.md
 docs/ACTIVITY_OUTPUT_PART.md
+docs/AGENT_RUNTIME_IMAGE.md
 docs/ARCHITECTURE_DIAGRAM.md
 docs/BUILTIN_SKILLS_REFERENCE.md
 docs/CANCEL_AND_INTERRUPT_FRONTEND.md

agent_framework_lib-0.8.12/docs/AGENT_RUNTIME_IMAGE.md

@@ -0,0 +1,71 @@
+# Image de runtime des agents — `ghcr.io/komus-ai/agent-framework-runtime`
+
+Image de base **officielle** pour tout agent construit sur `agent-framework-lib`. Elle règle une fois
+pour toutes ce que chaque agent redécouvrait dans sa propre image : la sandbox « castrée ».
+
+## Pourquoi
+
+Constaté sur Nexo (dev, 15/09/2026) : image `python:3.13-slim` maison, utilisateur non-root.
+Au démarrage la lib tente d'installer les libs système de Chromium (`playwright install-deps`) et
+Deno ; sans root → « apt-get not found », sans `unzip` → Deno échoue. Résultat : l'agent ne peut pas
+exporter un diagramme mermaid en PNG, et répond « je n'ai pas les droits root/sudo ». Corriger le
+Dockerfile de Nexo n'aurait réparé que Nexo.
+
+## Contenu
+
+| Composant | Détail |
+|---|---|
+| Python 3.13 + `uv` | base `python:3.13-slim` |
+| `agent-framework-lib[llamaindex]==<version>` | même version que le tag de l'image |
+| Chromium Playwright + libs système | `playwright install --with-deps chromium` (rendu PNG, captures) |
+| Deno | `~/.deno` (là où la lib le cherche) + `/usr/local/bin/deno` |
+| git, unzip, curl, ca-certificates | skill code-delivery, installeurs, healthcheck Mozart |
+| `SHELL_SANDBOX_PROVIDER=local` | pas d'OpenShell ; le shell tourne dans le conteneur |
+| **root** | à dessein : l'agent installe ce dont il a besoin (`apt-get`, `pip`, `npm`…) |
+
+L'isolation est celle du conteneur (réseau, pas de socket Docker, pas de volume hôte). Si un
+déploiement exige un utilisateur non-root, l'agent le pose dans son propre Dockerfile — mais il perd
+alors l'installation à chaud.
+
+Tags : `ghcr.io/komus-ai/agent-framework-runtime:<version>` (= version PyPI) et `:latest`.
+Architectures : `linux/amd64`, `linux/arm64` (VM Mozart Scaleway = arm64).
+
+## Utilisation dans un agent
+
+```dockerfile
+FROM ghcr.io/komus-ai/agent-framework-runtime:0.8.12
+
+WORKDIR /app
+# Deps figées par uv.lock (jamais de résolution à neuf au build : cf. incident anthropic 1.5.0).
+COPY pyproject.toml uv.lock ./
+RUN uv export --frozen --no-dev --no-emit-project --no-hashes -o /tmp/requirements.txt \
+ && uv pip install --system -r /tmp/requirements.txt
+COPY src ./src
+RUN uv pip install --system --no-deps .
+
+CMD ["python", "-m", "mon_agent.main"]
+```
+
+Le pin `agent-framework-lib==<version>` de l'agent et le tag de l'image doivent être identiques :
+l'agent réinstalle ses deps depuis son lock, l'image fournit le système (Chromium, Deno, git).
+
+## Publication
+
+- Automatique : workflow `.github/workflows/runtime-image.yml` sur tag `v*.*.*`, après attente de la
+  version sur PyPI.
+- Manuelle : `gh workflow run runtime-image.yml -f version=0.8.12` (version déjà sur PyPI).
+- **Visibilité** : un paquet GHCR est privé par défaut. Mozart construit les images d'agents avec le
+  CLI Docker du conteneur `mozart-server`, sans identifiants GHCR → le paquet doit être **public**
+  (GitHub → Packages → `agent-framework-runtime` → Package settings → Change visibility). À faire une
+  fois, à la première publication.
+
+## Vérifier une image
+
+```bash
+docker run --rm ghcr.io/komus-ai/agent-framework-runtime:0.8.12 sh -c '
+  whoami; deno --version | head -1; python -c "
+from playwright.sync_api import sync_playwright
+with sync_playwright() as p:
+    b = p.chromium.launch(headless=True); pg = b.new_page(); pg.set_content(\"<h1>ok</h1>\"); pg.screenshot(path=\"/tmp/t.png\"); b.close()
+print(\"chromium OK\")"'
+```

{agent_framework_lib-0.8.11 → agent_framework_lib-0.8.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-framework-lib"
-version = "0.8.11"
+version = "0.8.12"
 description = "A comprehensive Python framework for building and serving conversational AI agents with FastAPI"
 readme = {file = "README.md", content-type = "text/markdown"}
 license = {text = "MIT"}

agent_framework_lib-0.8.11/agent_framework/web/docs/Dockerfile

@@ -1,57 +0,0 @@
-# Example Dockerfile for deploying an agent using agent-framework-lib from PyPI
-# This is a minimal production-ready setup
-
-FROM python:3.13-slim
-
-# Set working directory
-WORKDIR /app
-
-# Install system dependencies required for Playwright and general operation
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    curl \
-    ca-certificates \
-    bubblewrap \
-    && rm -rf /var/lib/apt/lists/*
-
-# bubblewrap (bwrap) enables the in-container shell sandbox (FS jail / network
-# isolation). Enable it at runtime with SHELL_SANDBOX_MODE=bwrap. It runs
-# rootless via unprivileged user namespaces — ensure the platform allows them
-# (e.g. do NOT run with a seccomp profile blocking clone/unshare). When bwrap is
-# unavailable the shell falls back to resource-limits-only (SHELL_SANDBOX_MODE
-# degrades with a logged warning).
-
-# Install uv for fast package management
-COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
-
-# Copy your agent code
-COPY pyproject.toml ./
-COPY your_agent.py ./
-
-# Install agent-framework-lib with desired extras
-# Available extras: [llamaindex], [microsoft], [mongodb], [s3], [minio], [multimodal], [all]
-RUN uv pip install --system agent-framework-lib[all]
-
-# Install your project dependencies
-RUN uv sync --system
-
-# Run post-install to setup Playwright browsers and Deno (lazy install on first use)
-# This is optional - they will auto-install on first use if not done here
-RUN python -c "from agent_framework.utils.post_install import post_install; post_install()"
-
-# Create non-root user for security
-RUN adduser --disabled-password --gecos '' appuser && \
-    chown -R appuser:appuser /app
-USER appuser
-
-# Environment variables
-ENV PYTHONUNBUFFERED=1
-
-# Expose port
-EXPOSE 8000
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
-    CMD curl -f http://localhost:8000/health || exit 1
-
-# Run your agent
-CMD ["python", "your_agent.py"]