diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..1d61b79
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,53 @@
+name: CI
+
+on:
+ pull_request:
+ push:
+ branches: [main]
+
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ strategy:
+ matrix:
+ python-version: ["3.12"]
+
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Install uv
+ uses: astral-sh/setup-uv@v2
+ with:
+ version: "latest"
+
+ - name: Set up Python ${{ matrix.python-version }}
+ run: uv python install ${{ matrix.python-version }}
+
+ - name: Install dependencies
+ run: uv sync --all-groups
+
+ - name: Run ruff linter
+ run: uv run ruff check src/ tests/
+
+ - name: Run ruff formatter check
+ run: uv run ruff format --check src/ tests/
+
+ - name: Run mypy type checker
+ run: uv run mypy src/
+
+ - name: Run smoke tests
+ run: uv run pytest tests/smoke/ -v --no-cov -m smoke
+
+ - name: Run all tests with coverage
+ run: uv run pytest --cov=src/creative_agent --cov-fail-under=10 --cov-report=term-missing
+
+ pre-commit:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+
+ - uses: actions/setup-python@v5
+ with:
+ python-version: '3.12'
+
+ - uses: pre-commit/action@v3.0.1
diff --git a/.gitignore b/.gitignore
index b7faf40..1dac950 100644
--- a/.gitignore
+++ b/.gitignore
@@ -182,9 +182,9 @@ cython_debug/
.abstra/
# Visual Studio Code
-# Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
+# Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
# that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-# and can be added to the global gitignore or merged into this file. However, if you prefer,
+# and can be added to the global gitignore or merged into this file. However, if you prefer,
# you could uncomment the following to ignore the entire vscode folder
# .vscode/
@@ -205,3 +205,8 @@ cython_debug/
marimo/_static/
marimo/_lsp/
__marimo__/
+
+# Local test files with secrets (should use .env instead)
+/test_*.py
+/test_*.json
+/setup_bucket_policy.py
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
new file mode 100644
index 0000000..e25f017
--- /dev/null
+++ b/.pre-commit-config.yaml
@@ -0,0 +1,49 @@
+repos:
+ - repo: local
+ hooks:
+ # Prevent skipping tests
+ - id: no-skip-tests
+ name: No @pytest.mark.skip decorators allowed
+ entry: sh -c 'if grep -r "@pytest\.mark\.skip[^_]" --include="test_*.py" tests/ 2>/dev/null | grep -v skip_ci; then echo "❌ Found @pytest.mark.skip decorators! Tests must not be skipped."; exit 1; fi'
+ language: system
+ pass_filenames: false
+ always_run: true
+
+ # Ensure smoke tests pass
+ - id: smoke-tests
+ name: Run smoke tests (critical paths)
+ entry: uv run pytest tests/smoke/ -v --tb=short -m smoke
+ language: system
+ pass_filenames: false
+ stages: [manual]
+
+ - repo: https://github.com/pre-commit/pre-commit-hooks
+ rev: v6.0.0
+ hooks:
+ - id: trailing-whitespace
+ - id: end-of-file-fixer
+ - id: check-yaml
+ - id: check-added-large-files
+ args: ['--maxkb=1000']
+ - id: check-json
+ - id: check-merge-conflict
+ - id: check-ast
+ - id: debug-statements
+
+ - repo: https://github.com/astral-sh/ruff-pre-commit
+ rev: v0.8.0
+ hooks:
+ - id: ruff
+ args: [--fix]
+ - id: ruff-format
+
+ - repo: https://github.com/pre-commit/mirrors-mypy
+ rev: v1.18.2
+ hooks:
+ - id: mypy
+ files: ^src/
+ additional_dependencies:
+ - pydantic>=2.0.0
+ - types-pillow>=10.0.0
+ - boto3-stubs[s3]>=1.35.0
+ args: [--strict]
diff --git a/.python-version b/.python-version
new file mode 100644
index 0000000..e4fba21
--- /dev/null
+++ b/.python-version
@@ -0,0 +1 @@
+3.12
diff --git a/Dockerfile.fly b/Dockerfile.fly
new file mode 100644
index 0000000..a4d5a20
--- /dev/null
+++ b/Dockerfile.fly
@@ -0,0 +1,34 @@
+# Fly.io Dockerfile for AdCP Creative Agent
+# syntax=docker/dockerfile:1.4
+
+# Use AWS Public ECR to avoid Docker Hub rate limits
+FROM public.ecr.aws/docker/library/python:3.12-slim
+
+# Install dependencies
+RUN apt-get update && apt-get install -y \
+ curl \
+ && rm -rf /var/lib/apt/lists/*
+
+# Install uv for package management
+RUN pip install uv
+
+WORKDIR /app
+
+# Copy all files first
+COPY . .
+
+# Install dependencies (uv will create .venv)
+RUN uv sync
+
+# Add .venv to PATH
+ENV PATH="/app/.venv/bin:$PATH"
+ENV PYTHONUNBUFFERED=1
+
+# Service port
+ENV PORT=8080
+
+# Expose port
+EXPOSE 8080
+
+# Run the spec-compliant MCP server
+CMD ["python", "-m", "creative_agent.server"]
diff --git a/README.md b/README.md
index 3f5f594..dded44c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,498 @@
-# creative-agent
-A reference implementation of a creative agent
+# AdCP Creative Agent
+
+A production-grade MCP server providing AdCP creative format specifications and preview generation capabilities. This agent serves as the authoritative source for standard IAB creative formats with built-in preview generation using Tigris storage.
+
+## Overview
+
+The AdCP Creative Agent is a stateless service that:
+- Provides complete specifications for standard IAB creative formats (video, display, audio, native, DOOH)
+- Generates live previews from creative manifests using AI (Gemini)
+- Stores preview HTML in Tigris (Fly.io's S3-compatible global storage)
+- Supports both local development (stdio) and production deployment (HTTP)
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────┐
+│ MCP Client (Claude, Agent, etc.) │
+└───────────────┬─────────────────────────────────┘
+ │
+ │ MCP Protocol (stdio or HTTP)
+ │
+┌───────────────▼─────────────────────────────────┐
+│ AdCP Creative Agent │
+│ ┌───────────────────────────────────────────┐ │
+│ │ list_creative_formats │ │
+│ │ - Returns all standard format specs │ │
+│ └───────────────────────────────────────────┘ │
+│ ┌───────────────────────────────────────────┐ │
+│ │ build_creative (AI-powered) │ │
+│ │ - Generates creative using Gemini API │ │
+│ │ - Uses brand assets + user message │ │
+│ └───────────────────────────────────────────┘ │
+│ ┌───────────────────────────────────────────┐ │
+│ │ preview_creative │ │
+│ │ - Renders creative to HTML │ │
+│ │ - Uploads to Tigris storage │ │
+│ └───────────────────────────────────────────┘ │
+└─────────────────────────────────────────────────┘
+ │
+ │ S3 API
+ │
+┌───────────────▼─────────────────────────────────┐
+│ Tigris Global Object Storage │
+│ - Public bucket: adcp-previews │
+│ - Preview HTML files cached for 1 hour │
+│ - Public URLs: https://[bucket].fly.storage... │
+└─────────────────────────────────────────────────┘
+```
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.12+
+- [uv](https://github.com/astral-sh/uv) package manager
+- Fly.io account (for production deployment)
+
+### Local Development
+
+```bash
+# Install dependencies
+uv sync
+
+# Run server locally (stdio mode for MCP)
+uv run adcp-creative-agent
+
+# Run smoke tests
+uv run pytest tests/smoke/ -v -m smoke
+```
+
+### Testing with MCP Inspector
+
+For interactive testing and development:
+
+```bash
+# Start FastMCP development server
+uv run fastmcp dev src/creative_agent/server.py
+
+# Opens web UI at http://localhost:8000
+# - Test list_creative_formats
+# - Test preview_creative with sample manifests
+# - See real-time request/response JSON
+```
+
+### Connect to Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+ "mcpServers": {
+ "adcp-creative-agent": {
+ "command": "uv",
+ "args": ["run", "adcp-creative-agent"],
+ "cwd": "/absolute/path/to/creative-agent/.conductor/jackson-v1"
+ }
+ }
+}
+```
+
+Restart Claude Desktop to load the server.
+
+## Environment Variables
+
+### Required for Production
+
+```bash
+# Tigris S3 Storage (automatically set by Fly.io)
+AWS_ACCESS_KEY_ID=tid_xxxxx
+AWS_SECRET_ACCESS_KEY=tsec_xxxxx
+AWS_ENDPOINT_URL_S3=https://fly.storage.tigris.dev
+BUCKET_NAME=adcp-previews
+AWS_REGION=auto
+
+# Production flag
+PRODUCTION=true
+PORT=8080
+```
+
+### Setting Secrets on Fly.io
+
+```bash
+# Tigris credentials (from fly storage create)
+fly secrets set AWS_ACCESS_KEY_ID=tid_xxxxx
+fly secrets set AWS_SECRET_ACCESS_KEY=tsec_xxxxx
+fly secrets set AWS_ENDPOINT_URL_S3=https://fly.storage.tigris.dev
+fly secrets set BUCKET_NAME=adcp-previews
+```
+
+## MCP Tools
+
+### `list_creative_formats`
+
+Returns all available AdCP creative format specifications.
+
+**Response:** JSON array of AdCP `CreativeFormat` objects.
+
+See the [AdCP Creative Formats specification](https://github.com/anthropics/adcp) for complete schema and field definitions.
+
+### `build_creative`
+
+Generate a creative using AI (Gemini) based on brand assets and a user message.
+
+**Input:**
+- `message` (string, required) - User's advertising message/goal
+- `format_id` (string, required) - Target format ID from `list_creative_formats`
+- `gemini_api_key` (string, required) - User's Gemini API key (we don't store or pay for API calls)
+- `brand_card` (object, optional) - Brand information including colors, assets, guidelines
+
+**Output:**
+- `status` - "success" or "error"
+- `creative_output` - Generated creative manifest ready for preview
+- `context_id` - Unique identifier for this generation session
+
+**Example Request:**
+```json
+{
+ "message": "I want to advertise to tired dads with cats",
+ "format_id": "display_300x250_image",
+ "gemini_api_key": "AIzaSy...",
+ "brand_card": {
+ "name": "Kraft Mac & Cheese",
+ "colors": ["#FFD700", "#FF6600"],
+ "assets": [
+ {"type": "logo", "url": "https://example.com/logo.png"}
+ ]
+ }
+}
+```
+
+### `preview_creative`
+
+Generate HTML previews from a creative manifest and upload to Tigris.
+
+**Input:**
+- `format_id` (string, required) - Format identifier
+- `creative_manifest` (object, required) - Creative manifest with assets
+- `inputs` (array, optional) - Preview variations with macro substitutions
+
+**Output:**
+- `preview_id` - Unique preview session ID
+- `previews` - Array of preview objects with URLs
+- `expires_at` - ISO timestamp when previews expire (24 hours)
+
+**Example Request:**
+```json
+{
+ "format_id": "display_300x250_image",
+ "creative_manifest": {
+ "format_id": "display_300x250_image",
+ "assets": {
+ "image": {
+ "asset_type": "image",
+ "url": "https://example.com/banner.jpg"
+ },
+ "click_url": {
+ "asset_type": "url",
+ "url": "https://example.com/landing"
+ }
+ }
+ },
+ "inputs": [
+ {"name": "Desktop", "macros": {"DEVICE_TYPE": "desktop"}},
+ {"name": "Mobile", "macros": {"DEVICE_TYPE": "mobile"}}
+ ]
+}
+```
+
+**Example Response:**
+```json
+{
+ "preview_id": "550e8400-e29b-41d4-a716-446655440000",
+ "previews": [
+ {
+ "input": {"name": "Desktop", "macros": {"DEVICE_TYPE": "desktop"}},
+ "preview_url": "https://adcp-previews.fly.storage.tigris.dev/previews/550e8400.../Desktop.html",
+ "hints": {
+ "estimated_dimensions": {"width": 300, "height": 250},
+ "primary_media_type": "image",
+ "contains_audio": false,
+ "contains_video": false
+ }
+ }
+ ],
+ "expires_at": "2025-10-12T13:00:00Z"
+}
+```
+
+## Supported AdCP Formats
+
+Use the `list_creative_formats` MCP tool to see all available formats with complete specifications.
+
+The agent supports 38 AdCP-compliant formats across video, display, audio, native, DOOH, and generative categories. All formats include standard IAB macro support for privacy compliance (GDPR, CCPA, GPP), device info, and tracking.
+
+## How to Add New Creative Format Templates
+
+Creative formats are defined in `/src/creative_agent/data/standard_formats.py`. To add a new format:
+
+### 1. Define the Format
+
+Add a new `CreativeFormat` object to the appropriate format list (VIDEO_FORMATS, DISPLAY_FORMATS, etc.):
+
+```python
+CreativeFormat(
+ format_id="display_300x600_image", # Unique ID (use descriptive naming)
+ agent_url=AGENT_URL, # Keep this as AGENT_URL
+ name="Half Page - Image", # Human-readable name
+ type="display", # video|display|audio|native|dooh|interactive
+ category="standard", # standard|custom
+ is_standard=True, # True for IAB standard formats
+ description="300x600 half-page display ad with static image",
+ dimensions="300x600", # Width x Height (if applicable)
+ accepts_3p_tags=False, # True if format accepts third-party tags
+ supported_macros=COMMON_MACROS, # Macro support (privacy, device, tracking)
+ requirements=FormatRequirements( # Optional technical requirements
+ max_file_size_mb=1.0,
+ acceptable_formats=["jpg", "png", "gif"],
+ ),
+ assets_required=[ # List of required/optional assets
+ AssetRequirement(
+ asset_role="image", # Unique identifier for this asset
+ asset_type="image", # image|video|audio|text|html|url|vast_tag
+ required=True, # Is this asset required?
+ width=300, # Asset width (optional)
+ height=600, # Asset height (optional)
+ max_file_size_mb=1.0, # Max file size (optional)
+ acceptable_formats=["jpg", "png", "gif"], # Acceptable formats
+ description="Main display image for 300x600 half-page ad",
+ ),
+ AssetRequirement(
+ asset_role="click_url",
+ asset_type="url",
+ required=True,
+ description="Landing page URL for click-through",
+ ),
+ ],
+)
+```
+
+### 2. Add to Format List
+
+Ensure your format is added to the appropriate list:
+
+```python
+# At the bottom of standard_formats.py
+STANDARD_FORMATS = (
+ VIDEO_FORMATS
+ + DISPLAY_FORMATS # Your format should be in one of these
+ + NATIVE_FORMATS
+ + AUDIO_FORMATS
+ + DOOH_FORMATS
+)
+```
+
+### 3. Test Your Format
+
+```bash
+# Test that the format appears in list_creative_formats
+uv run fastmcp dev src/creative_agent/server.py
+
+# In the web UI, call list_creative_formats and search for your format_id
+```
+
+### 4. Asset Types Reference
+
+- `image` - Static image (JPG, PNG, GIF, WebP)
+- `video` - Video file (MP4, MOV, WebM)
+- `audio` - Audio file (MP3, AAC, WAV)
+- `text` - Text content (headline, body, CTA)
+- `html` - HTML5 creative code
+- `url` - URL string (click-through, landing page)
+- `vast_tag` - VAST XML tag URL
+
+### 5. Macro Support
+
+Standard macros (included in `COMMON_MACROS`):
+- Privacy: `GDPR`, `GDPR_CONSENT`, `US_PRIVACY`, `GPP_STRING`
+- Tracking: `MEDIA_BUY_ID`, `CREATIVE_ID`, `IMPRESSION_URL`, `CLICK_URL`
+- Device: `DEVICE_TYPE`, `OS`, `OS_VERSION`, `USER_AGENT`
+- Context: `CACHEBUSTER`
+
+Add custom macros for specific format needs:
+```python
+supported_macros=COMMON_MACROS + ["VIDEO_ID", "POD_POSITION", "CONTENT_GENRE"]
+```
+
+### 6. IAB Specification Links
+
+For standard IAB formats, include specification URLs:
+- Video: `https://iabtechlab.com/standards/video-ad-serving-template-vast/`
+- Native: `https://iabtechlab.com/standards/openrtb-native/`
+- Display: `https://iabtechlab.com/ad-experiences/display-ad-formats/`
+
+## Deployment
+
+### Initial Setup
+
+```bash
+# 1. Create Fly.io app
+fly launch
+
+# 2. Create public Tigris bucket
+fly storage create --name adcp-previews --org personal --public -y
+
+# 3. Set environment variables
+fly secrets set AWS_ACCESS_KEY_ID=tid_xxxxx
+fly secrets set AWS_SECRET_ACCESS_KEY=tsec_xxxxx
+fly secrets set AWS_ENDPOINT_URL_S3=https://fly.storage.tigris.dev
+fly secrets set BUCKET_NAME=adcp-previews
+fly secrets set AWS_REGION=auto
+```
+
+### Deploy Updates
+
+```bash
+# Deploy to production
+fly deploy
+
+# Check logs
+fly logs
+
+# Check app status
+fly status
+```
+
+### Health Checks
+
+The server includes automatic health checks configured in `fly.toml`:
+- TCP health checks every 30s
+- 60s grace period for startup
+- Auto-start/stop for cost optimization
+
+## Development
+
+### Project Structure
+
+```
+.
+├── src/creative_agent/
+│ ├── server.py # Main MCP server (basic tools)
+│ ├── server_v2.py # Extended server with AI generation
+│ ├── storage.py # Tigris storage integration
+│ ├── data/
+│ │ ├── formats.py # Format utilities
+│ │ └── standard_formats.py # All format definitions
+│ └── schemas/
+│ ├── format.py # Format data models
+│ ├── manifest.py # Creative manifest models
+│ ├── assets.py # Asset models
+│ ├── preview.py # Preview request/response models
+│ └── build.py # AI generation models
+├── tests/
+│ └── smoke/
+│ └── test_server_startup.py
+├── pyproject.toml # Project dependencies
+├── fly.toml # Fly.io deployment config
+└── Dockerfile.fly # Production container image
+```
+
+### Code Quality
+
+```bash
+# Run linter
+uv run ruff check src/
+
+# Run type checker
+uv run mypy src/
+
+# Run tests with coverage
+uv run pytest --cov=src/creative_agent tests/
+```
+
+### Pre-commit Hooks
+
+```bash
+# Install pre-commit hooks
+uv run pre-commit install
+
+# Run hooks manually
+uv run pre-commit run --all-files
+```
+
+## Security
+
+### Secrets Management
+
+NEVER commit these to version control:
+- AWS/Tigris credentials
+- Gemini API keys
+- Any user-provided API keys
+
+Use environment variables and `.env` files (gitignored):
+```bash
+# .env (local development)
+AWS_ACCESS_KEY_ID=tid_xxxxx
+AWS_SECRET_ACCESS_KEY=tsec_xxxxx
+AWS_ENDPOINT_URL_S3=https://fly.storage.tigris.dev
+BUCKET_NAME=adcp-previews
+```
+
+### Production Checklist
+
+- [ ] All secrets set via `fly secrets set`
+- [ ] Tigris bucket created with `--public` flag
+- [ ] Preview URLs tested and accessible
+- [ ] Health checks passing
+- [ ] Logs monitoring configured
+- [ ] Error tracking enabled (Sentry/similar)
+
+## Troubleshooting
+
+### Preview URLs Return 403 Access Denied
+
+**Problem:** Presigned URLs returning access denied errors.
+
+**Solution:** The bucket was created with `--public` flag, so we use direct virtual-hosted-style URLs instead of presigned URLs:
+```
+https://[bucket-name].fly.storage.tigris.dev/[object-key]
+```
+
+This is already implemented in `storage.py` (v2).
+
+### Server Won't Start on Fly.io
+
+Check logs:
+```bash
+fly logs
+```
+
+Common issues:
+- Missing environment variables
+- Port mismatch (should be 8080)
+- Dockerfile build errors
+
+### Tests Fail Locally
+
+Ensure dependencies are installed:
+```bash
+uv sync
+```
+
+For Tigris-dependent tests, set environment variables in `.env`.
+
+## Contributing
+
+1. Create feature branch from `main`
+2. Add tests for new functionality
+3. Run linter and tests
+4. Create pull request with description
+5. Ensure CI passes
+
+## License
+
+MIT License - see LICENSE file
+
+## Spec Reference
+
+Format specifications from [AdCP Media Buy Protocol](https://adcontextprotocol.org/docs/media-buy/capability-discovery/creative-formats)
diff --git a/coverage.json b/coverage.json
new file mode 100644
index 0000000..b959469
--- /dev/null
+++ b/coverage.json
@@ -0,0 +1 @@
+{"meta": {"format": 3, "version": "7.10.7", "timestamp": "2025-10-12T21:02:53.089073", "branch_coverage": false, "show_contexts": false}, "files": {"src/creative_agent/__init__.py": {"executed_lines": [1, 3], "summary": {"covered_lines": 1, "num_statements": 1, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": [], "functions": {"": {"executed_lines": [1, 3], "summary": {"covered_lines": 1, "num_statements": 1, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}, "classes": {"": {"executed_lines": [1, 3], "summary": {"covered_lines": 1, "num_statements": 1, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}}, "src/creative_agent/api_server.py": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 53, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 53, "excluded_lines": 0}, "missing_lines": [3, 4, 5, 7, 8, 9, 11, 13, 16, 25, 28, 29, 30, 31, 34, 35, 37, 47, 48, 50, 53, 54, 56, 59, 60, 62, 63, 64, 65, 66, 69, 70, 73, 74, 75, 78, 81, 82, 83, 84, 85, 87, 95, 96, 97, 98, 100, 110, 112, 121, 122, 124, 125], "excluded_lines": [], "functions": {"root": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 1, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 1, "excluded_lines": 0}, "missing_lines": [37], "excluded_lines": []}, "health": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 1, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 1, "excluded_lines": 0}, "missing_lines": [50], "excluded_lines": []}, "list_formats": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 1, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 1, "excluded_lines": 0}, "missing_lines": [56], "excluded_lines": []}, "get_format": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 5, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 5, "excluded_lines": 0}, "missing_lines": [62, 63, 64, 65, 66], "excluded_lines": []}, "preview_creative": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 17, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 17, "excluded_lines": 0}, "missing_lines": [73, 74, 75, 78, 81, 82, 83, 84, 85, 87, 95, 96, 97, 98, 100, 110, 112], "excluded_lines": []}, "": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 28, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 28, "excluded_lines": 0}, "missing_lines": [3, 4, 5, 7, 8, 9, 11, 13, 16, 25, 28, 29, 30, 31, 34, 35, 47, 48, 53, 54, 59, 60, 69, 70, 121, 122, 124, 125], "excluded_lines": []}}, "classes": {"PreviewRequest": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 53, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 53, "excluded_lines": 0}, "missing_lines": [3, 4, 5, 7, 8, 9, 11, 13, 16, 25, 28, 29, 30, 31, 34, 35, 37, 47, 48, 50, 53, 54, 56, 59, 60, 62, 63, 64, 65, 66, 69, 70, 73, 74, 75, 78, 81, 82, 83, 84, 85, 87, 95, 96, 97, 98, 100, 110, 112, 121, 122, 124, 125], "excluded_lines": []}}}, "src/creative_agent/data/standard_formats.py": {"executed_lines": [1, 3, 6, 7, 8, 11, 25, 218, 472, 673, 810, 914, 993, 1100, 1111, 1113, 1114, 1115, 1119], "summary": {"covered_lines": 18, "num_statements": 32, "percent_covered": 56.25, "percent_covered_display": "56", "missing_lines": 14, "excluded_lines": 0}, "missing_lines": [1116, 1127, 1129, 1130, 1132, 1133, 1135, 1136, 1138, 1139, 1140, 1142, 1144, 1153], "excluded_lines": [], "functions": {"get_format_by_id": {"executed_lines": [1113, 1114, 1115], "summary": {"covered_lines": 3, "num_statements": 4, "percent_covered": 75.0, "percent_covered_display": "75", "missing_lines": 1, "excluded_lines": 0}, "missing_lines": [1116], "excluded_lines": []}, "filter_formats": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 13, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 13, "excluded_lines": 0}, "missing_lines": [1127, 1129, 1130, 1132, 1133, 1135, 1136, 1138, 1139, 1140, 1142, 1144, 1153], "excluded_lines": []}, "": {"executed_lines": [1, 3, 6, 7, 8, 11, 25, 218, 472, 673, 810, 914, 993, 1100, 1111, 1119], "summary": {"covered_lines": 15, "num_statements": 15, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}, "classes": {"": {"executed_lines": [1, 3, 6, 7, 8, 11, 25, 218, 472, 673, 810, 914, 993, 1100, 1111, 1113, 1114, 1115, 1119], "summary": {"covered_lines": 18, "num_statements": 32, "percent_covered": 56.25, "percent_covered_display": "56", "missing_lines": 14, "excluded_lines": 0}, "missing_lines": [1116, 1127, 1129, 1130, 1132, 1133, 1135, 1136, 1138, 1139, 1140, 1142, 1144, 1153], "excluded_lines": []}}}, "src/creative_agent/http_server.py": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 5, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 5, "excluded_lines": 0}, "missing_lines": [3, 5, 8, 10, 12], "excluded_lines": [], "functions": {"": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 5, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 5, "excluded_lines": 0}, "missing_lines": [3, 5, 8, 10, 12], "excluded_lines": []}}, "classes": {"": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 5, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 5, "excluded_lines": 0}, "missing_lines": [3, 5, 8, 10, 12], "excluded_lines": []}}}, "src/creative_agent/schemas/__init__.py": {"executed_lines": [1, 3, 15, 22, 30], "summary": {"covered_lines": 4, "num_statements": 4, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": [], "functions": {"": {"executed_lines": [1, 3, 15, 22, 30], "summary": {"covered_lines": 4, "num_statements": 4, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}, "classes": {"": {"executed_lines": [1, 3, 15, 22, 30], "summary": {"covered_lines": 4, "num_statements": 4, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}}, "src/creative_agent/schemas/assets.py": {"executed_lines": [1, 3, 5, 8, 9, 11, 12, 13, 14, 15, 16, 17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34, 35, 37, 38, 39, 40, 41, 42, 43, 44, 45, 48, 49, 51, 52, 53, 54, 55, 58, 59, 61, 62, 63, 64, 67, 68, 70, 71, 72, 75, 76, 78, 79, 80, 81, 82, 83, 86, 87, 89, 90, 91, 92, 95, 96, 98, 99, 100, 101, 102, 103, 104, 105, 108, 109, 111, 112, 116], "summary": {"covered_lines": 70, "num_statements": 70, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": [], "functions": {"": {"executed_lines": [1, 3, 5, 8, 9, 11, 12, 13, 14, 15, 16, 17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34, 35, 37, 38, 39, 40, 41, 42, 43, 44, 45, 48, 49, 51, 52, 53, 54, 55, 58, 59, 61, 62, 63, 64, 67, 68, 70, 71, 72, 75, 76, 78, 79, 80, 81, 82, 83, 86, 87, 89, 90, 91, 92, 95, 96, 98, 99, 100, 101, 102, 103, 104, 105, 108, 109, 111, 112, 116], "summary": {"covered_lines": 70, "num_statements": 70, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}, "classes": {"ImageAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "VideoAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "AudioAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "VastTagAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "TextAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "UrlAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "HtmlAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "JavaScriptAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "WebhookAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PromotedOfferingsAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "": {"executed_lines": [1, 3, 5, 8, 9, 11, 12, 13, 14, 15, 16, 17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34, 35, 37, 38, 39, 40, 41, 42, 43, 44, 45, 48, 49, 51, 52, 53, 54, 55, 58, 59, 61, 62, 63, 64, 67, 68, 70, 71, 72, 75, 76, 78, 79, 80, 81, 82, 83, 86, 87, 89, 90, 91, 92, 95, 96, 98, 99, 100, 101, 102, 103, 104, 105, 108, 109, 111, 112, 116], "summary": {"covered_lines": 70, "num_statements": 70, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}}, "src/creative_agent/schemas/brand_card.py": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 17, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 17, "excluded_lines": 0}, "missing_lines": [3, 6, 9, 10, 11, 12, 13, 14, 15, 18, 21, 22, 23, 24, 25, 26, 27], "excluded_lines": [], "functions": {"": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 17, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 17, "excluded_lines": 0}, "missing_lines": [3, 6, 9, 10, 11, 12, 13, 14, 15, 18, 21, 22, 23, 24, 25, 26, 27], "excluded_lines": []}}, "classes": {"BrandAsset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "BrandCard": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 17, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 17, "excluded_lines": 0}, "missing_lines": [3, 6, 9, 10, 11, 12, 13, 14, 15, 18, 21, 22, 23, 24, 25, 26, 27], "excluded_lines": []}}}, "src/creative_agent/schemas/build.py": {"executed_lines": [1, 3, 5, 8, 9, 11, 12, 13, 14, 17, 18, 20, 21, 24, 25, 27, 28, 31, 32, 34, 35, 36, 37, 38, 39, 40, 41, 43, 46, 47, 49, 50, 51, 54, 55, 57, 58, 59, 60, 61, 62], "summary": {"covered_lines": 34, "num_statements": 34, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": [], "functions": {"": {"executed_lines": [1, 3, 5, 8, 9, 11, 12, 13, 14, 17, 18, 20, 21, 24, 25, 27, 28, 31, 32, 34, 35, 36, 37, 38, 39, 40, 41, 43, 46, 47, 49, 50, 51, 54, 55, 57, 58, 59, 60, 61, 62], "summary": {"covered_lines": 34, "num_statements": 34, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}, "classes": {"AssetReference": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewContext": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewOptions": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "BuildCreativeRequest": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "CreativeOutput": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "BuildCreativeResponse": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "": {"executed_lines": [1, 3, 5, 8, 9, 11, 12, 13, 14, 17, 18, 20, 21, 24, 25, 27, 28, 31, 32, 34, 35, 36, 37, 38, 39, 40, 41, 43, 46, 47, 49, 50, 51, 54, 55, 57, 58, 59, 60, 61, 62], "summary": {"covered_lines": 34, "num_statements": 34, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}}, "src/creative_agent/schemas/format.py": {"executed_lines": [1, 3, 5, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18, 19, 22, 23, 25, 26, 27, 28, 29, 30, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 52, 53, 55, 56, 59, 60, 61, 64, 65, 67, 68, 69, 70, 71, 72], "summary": {"covered_lines": 47, "num_statements": 47, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": [], "functions": {"": {"executed_lines": [1, 3, 5, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18, 19, 22, 23, 25, 26, 27, 28, 29, 30, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 52, 53, 55, 56, 59, 60, 61, 64, 65, 67, 68, 69, 70, 71, 72], "summary": {"covered_lines": 47, "num_statements": 47, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}, "classes": {"AssetRequirement": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "FormatRequirements": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "CreativeFormat": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "ListCreativeFormatsRequest": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "ListCreativeFormatsResponse": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "": {"executed_lines": [1, 3, 5, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18, 19, 22, 23, 25, 26, 27, 28, 29, 30, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 52, 53, 55, 56, 59, 60, 61, 64, 65, 67, 68, 69, 70, 71, 72], "summary": {"covered_lines": 47, "num_statements": 47, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}}, "src/creative_agent/schemas/library.py": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 36, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 36, "excluded_lines": 0}, "missing_lines": [3, 5, 8, 11, 12, 13, 14, 15, 16, 19, 22, 23, 24, 25, 26, 27, 28, 29, 30, 33, 36, 37, 38, 41, 44, 45, 46, 47, 48, 49, 50, 51, 54, 57, 58, 59], "excluded_lines": [], "functions": {"": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 36, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 36, "excluded_lines": 0}, "missing_lines": [3, 5, 8, 11, 12, 13, 14, 15, 16, 19, 22, 23, 24, 25, 26, 27, 28, 29, 30, 33, 36, 37, 38, 41, 44, 45, 46, 47, 48, 49, 50, 51, 54, 57, 58, 59], "excluded_lines": []}}, "classes": {"AssetMetadata": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "Asset": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "SearchFilters": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "ManageCreativeLibraryRequest": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "ManageCreativeLibraryResponse": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 36, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 36, "excluded_lines": 0}, "missing_lines": [3, 5, 8, 11, 12, 13, 14, 15, 16, 19, 22, 23, 24, 25, 26, 27, 28, 29, 30, 33, 36, 37, 38, 41, 44, 45, 46, 47, 48, 49, 50, 51, 54, 57, 58, 59], "excluded_lines": []}}}, "src/creative_agent/schemas/manifest.py": {"executed_lines": [1, 3, 5, 7, 10, 11, 13, 14, 15, 16, 19, 20, 22, 23, 24, 27, 28, 30, 31, 32, 33, 34, 35, 36, 39, 40, 42, 43, 44, 45, 46, 49, 50, 52, 53, 54, 55, 58, 59, 61, 62, 63, 64, 67, 68, 70, 71, 72, 73], "summary": {"covered_lines": 41, "num_statements": 41, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": [], "functions": {"": {"executed_lines": [1, 3, 5, 7, 10, 11, 13, 14, 15, 16, 19, 20, 22, 23, 24, 27, 28, 30, 31, 32, 33, 34, 35, 36, 39, 40, 42, 43, 44, 45, 46, 49, 50, 52, 53, 54, 55, 58, 59, 61, 62, 63, 64, 67, 68, 70, 71, 72, 73], "summary": {"covered_lines": 41, "num_statements": 41, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}, "classes": {"CreativeManifest": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewInput": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewCreativeRequest": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewHints": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewEmbedding": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewVariant": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewCreativeResponse": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "": {"executed_lines": [1, 3, 5, 7, 10, 11, 13, 14, 15, 16, 19, 20, 22, 23, 24, 27, 28, 30, 31, 32, 33, 34, 35, 36, 39, 40, 42, 43, 44, 45, 46, 49, 50, 52, 53, 54, 55, 58, 59, 61, 62, 63, 64, 67, 68, 70, 71, 72, 73], "summary": {"covered_lines": 41, "num_statements": 41, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}}}, "src/creative_agent/schemas/preview.py": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 26, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 26, "excluded_lines": 0}, "missing_lines": [3, 5, 8, 11, 12, 13, 14, 15, 16, 19, 22, 23, 24, 25, 26, 27, 28, 31, 34, 35, 36, 37, 38, 41, 44, 45], "excluded_lines": [], "functions": {"": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 26, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 26, "excluded_lines": 0}, "missing_lines": [3, 5, 8, 11, 12, 13, 14, 15, 16, 19, 22, 23, 24, 25, 26, 27, 28, 31, 34, 35, 36, 37, 38, 41, 44, 45], "excluded_lines": []}}, "classes": {"PreviewVariant": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewCreativeRequest": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewResponse": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "PreviewCreativeResponse": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 0, "percent_covered": 100.0, "percent_covered_display": "100", "missing_lines": 0, "excluded_lines": 0}, "missing_lines": [], "excluded_lines": []}, "": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 26, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 26, "excluded_lines": 0}, "missing_lines": [3, 5, 8, 11, 12, 13, 14, 15, 16, 19, 22, 23, 24, 25, 26, 27, 28, 31, 34, 35, 36, 37, 38, 41, 44, 45], "excluded_lines": []}}}, "src/creative_agent/server.py": {"executed_lines": [1, 3, 4, 5, 6, 7, 9, 11, 18, 19, 20, 22, 25, 26, 66, 67, 177, 227, 228, 589], "summary": {"covered_lines": 19, "num_statements": 216, "percent_covered": 8.796296296296296, "percent_covered_display": "9", "missing_lines": 197, "excluded_lines": 0}, "missing_lines": [45, 46, 54, 61, 62, 63, 90, 92, 95, 98, 99, 100, 103, 114, 115, 116, 122, 123, 131, 132, 135, 136, 143, 145, 147, 150, 151, 154, 161, 164, 166, 172, 173, 174, 185, 188, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 204, 207, 208, 209, 210, 213, 219, 259, 261, 262, 271, 273, 274, 277, 278, 279, 282, 283, 284, 287, 288, 289, 292, 293, 299, 312, 313, 314, 320, 321, 322, 323, 324, 328, 331, 332, 334, 338, 340, 345, 346, 347, 348, 350, 352, 353, 354, 355, 356, 359, 360, 361, 362, 365, 366, 367, 368, 369, 370, 371, 372, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 387, 392, 394, 395, 420, 443, 446, 449, 451, 453, 454, 455, 456, 459, 460, 463, 464, 465, 466, 467, 469, 470, 471, 474, 475, 476, 479, 482, 484, 486, 488, 494, 499, 500, 502, 503, 504, 505, 506, 508, 509, 511, 513, 515, 516, 517, 518, 521, 523, 524, 525, 528, 531, 534, 535, 536, 537, 538, 540, 541, 544, 547, 550, 551, 552, 553, 555, 558, 575, 577, 578, 582, 583, 591, 592, 593, 596], "excluded_lines": [], "functions": {"list_creative_formats": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 6, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 6, "excluded_lines": 0}, "missing_lines": [45, 46, 54, 61, 62, 63], "excluded_lines": []}, "preview_creative": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 28, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 28, "excluded_lines": 0}, "missing_lines": [90, 92, 95, 98, 99, 100, 103, 114, 115, 116, 122, 123, 131, 132, 135, 136, 143, 145, 147, 150, 151, 154, 161, 164, 166, 172, 173, 174], "excluded_lines": []}, "_generate_preview_variant": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 22, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 22, "excluded_lines": 0}, "missing_lines": [185, 188, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 204, 207, 208, 209, 210, 213, 219], "excluded_lines": []}, "build_creative": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 137, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 137, "excluded_lines": 0}, "missing_lines": [259, 261, 262, 271, 273, 274, 277, 278, 279, 282, 283, 284, 287, 288, 289, 292, 293, 299, 312, 313, 314, 320, 321, 322, 323, 324, 328, 331, 332, 334, 338, 340, 345, 346, 347, 348, 350, 352, 353, 354, 355, 356, 359, 360, 361, 362, 365, 366, 367, 368, 369, 370, 371, 372, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 387, 392, 394, 395, 420, 443, 446, 449, 451, 453, 454, 455, 456, 459, 460, 463, 464, 465, 466, 467, 469, 470, 471, 474, 475, 476, 479, 482, 484, 486, 488, 494, 499, 500, 502, 503, 504, 505, 506, 508, 509, 511, 513, 515, 516, 517, 518, 521, 523, 524, 525, 528, 531, 534, 535, 536, 537, 538, 540, 541, 544, 547, 550, 551, 552, 553, 555, 558, 575, 577, 578, 582, 583], "excluded_lines": []}, "": {"executed_lines": [1, 3, 4, 5, 6, 7, 9, 11, 18, 19, 20, 22, 25, 26, 66, 67, 177, 227, 228, 589], "summary": {"covered_lines": 19, "num_statements": 23, "percent_covered": 82.6086956521739, "percent_covered_display": "83", "missing_lines": 4, "excluded_lines": 0}, "missing_lines": [591, 592, 593, 596], "excluded_lines": []}}, "classes": {"": {"executed_lines": [1, 3, 4, 5, 6, 7, 9, 11, 18, 19, 20, 22, 25, 26, 66, 67, 177, 227, 228, 589], "summary": {"covered_lines": 19, "num_statements": 216, "percent_covered": 8.796296296296296, "percent_covered_display": "9", "missing_lines": 197, "excluded_lines": 0}, "missing_lines": [45, 46, 54, 61, 62, 63, 90, 92, 95, 98, 99, 100, 103, 114, 115, 116, 122, 123, 131, 132, 135, 136, 143, 145, 147, 150, 151, 154, 161, 164, 166, 172, 173, 174, 185, 188, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 204, 207, 208, 209, 210, 213, 219, 259, 261, 262, 271, 273, 274, 277, 278, 279, 282, 283, 284, 287, 288, 289, 292, 293, 299, 312, 313, 314, 320, 321, 322, 323, 324, 328, 331, 332, 334, 338, 340, 345, 346, 347, 348, 350, 352, 353, 354, 355, 356, 359, 360, 361, 362, 365, 366, 367, 368, 369, 370, 371, 372, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 387, 392, 394, 395, 420, 443, 446, 449, 451, 453, 454, 455, 456, 459, 460, 463, 464, 465, 466, 467, 469, 470, 471, 474, 475, 476, 479, 482, 484, 486, 488, 494, 499, 500, 502, 503, 504, 505, 506, 508, 509, 511, 513, 515, 516, 517, 518, 521, 523, 524, 525, 528, 531, 534, 535, 536, 537, 538, 540, 541, 544, 547, 550, 551, 552, 553, 555, 558, 575, 577, 578, 582, 583, 591, 592, 593, 596], "excluded_lines": []}}}, "src/creative_agent/storage.py": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 44, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 44, "excluded_lines": 0}, "missing_lines": [2, 3, 5, 6, 9, 10, 11, 12, 13, 16, 18, 28, 39, 42, 45, 55, 59, 71, 72, 73, 74, 75, 76, 77, 80, 81, 82, 83, 84, 87, 88, 89, 90, 91, 94, 135, 136, 138, 140, 146, 147, 149, 151, 156], "excluded_lines": [], "functions": {"get_s3_client": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 1, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 1, "excluded_lines": 0}, "missing_lines": [18], "excluded_lines": []}, "upload_preview_html": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 4, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 4, "excluded_lines": 0}, "missing_lines": [39, 42, 45, 55], "excluded_lines": []}, "generate_preview_html": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 27, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 27, "excluded_lines": 0}, "missing_lines": [71, 72, 73, 74, 75, 76, 77, 80, 81, 82, 83, 84, 87, 88, 89, 90, 91, 94, 135, 136, 138, 140, 146, 147, 149, 151, 156], "excluded_lines": []}, "": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 12, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 12, "excluded_lines": 0}, "missing_lines": [2, 3, 5, 6, 9, 10, 11, 12, 13, 16, 28, 59], "excluded_lines": []}}, "classes": {"": {"executed_lines": [], "summary": {"covered_lines": 0, "num_statements": 44, "percent_covered": 0.0, "percent_covered_display": "0", "missing_lines": 44, "excluded_lines": 0}, "missing_lines": [2, 3, 5, 6, 9, 10, 11, 12, 13, 16, 18, 28, 39, 42, 45, 55, 59, 71, 72, 73, 74, 75, 76, 77, 80, 81, 82, 83, 84, 87, 88, 89, 90, 91, 94, 135, 136, 138, 140, 146, 147, 149, 151, 156], "excluded_lines": []}}}}, "totals": {"covered_lines": 234, "num_statements": 626, "percent_covered": 37.38019169329073, "percent_covered_display": "37", "missing_lines": 392, "excluded_lines": 0}}
diff --git a/fly.toml b/fly.toml
new file mode 100644
index 0000000..fada476
--- /dev/null
+++ b/fly.toml
@@ -0,0 +1,41 @@
+# fly.toml app configuration file for AdCP Creative Agent
+
+app = "adcp-creative-agent"
+primary_region = "iad"
+
+[build]
+ dockerfile = "Dockerfile.fly"
+
+[[services]]
+ internal_port = 8080
+ protocol = "tcp"
+ auto_stop_machines = "stop"
+ auto_start_machines = true
+ min_machines_running = 0
+
+ [services.concurrency]
+ type = "connections"
+ hard_limit = 100
+ soft_limit = 80
+
+ [[services.ports]]
+ port = 443
+ handlers = ["http", "tls"]
+
+ [[services.ports]]
+ port = 80
+ handlers = ["http"]
+
+ [[services.tcp_checks]]
+ interval = "30s"
+ grace_period = "60s"
+ timeout = "10s"
+
+[[vm]]
+ memory = "1gb"
+ cpu_kind = "shared"
+ cpus = 1
+
+[env]
+ PRODUCTION = "true"
+ PORT = "8080"
diff --git a/mcp_server.py b/mcp_server.py
new file mode 100644
index 0000000..1bff99c
--- /dev/null
+++ b/mcp_server.py
@@ -0,0 +1,121 @@
+"""FastMCP server for AdCP Creative Agent v1 - standalone entry point.
+
+Focuses on:
+1. list_creative_formats - Returns all AdCP creative formats
+2. preview_creative - Generates previews from creative manifests
+"""
+
+import json
+import sys
+import uuid
+from pathlib import Path
+
+# Add src to path so we can import
+sys.path.insert(0, str(Path(__file__).parent / "src"))
+
+from fastmcp import FastMCP
+
+from creative_agent.data.formats import STANDARD_FORMATS, get_format_by_id
+
+mcp = FastMCP("adcp-creative-agent")
+
+
+@mcp.tool()
+def list_creative_formats() -> str:
+ """List all available AdCP creative formats.
+
+ Returns all standard creative formats defined in the AdCP spec including
+ video, display, audio, DOOH, and foundational interactive formats.
+
+ Returns:
+ JSON array of creative format objects with format_id, name, type, dimensions, etc.
+ """
+ formats_data = [fmt.model_dump() for fmt in STANDARD_FORMATS]
+ return json.dumps(formats_data, indent=2)
+
+
+@mcp.tool()
+def preview_creative(manifest_json: str) -> str:
+ """Generate a preview from a creative manifest.
+
+ Takes a creative manifest and generates a rendered preview.
+ Returns a URL or iframe HTML for viewing the creative.
+
+ Args:
+ manifest_json: JSON creative manifest with format_id and creative assets
+
+ Returns:
+ JSON with preview_url, iframe_html, and rendered creative details
+
+ Example manifest:
+ {
+ "format_id": "display_banner",
+ "assets": {
+ "image": "https://example.com/banner.jpg",
+ "click_url": "https://example.com/landing"
+ },
+ "width": 300,
+ "height": 250
+ }
+ """
+ try:
+ manifest = json.loads(manifest_json)
+
+ # Validate format exists
+ format_id = manifest.get("format_id")
+ if not format_id:
+ return json.dumps({"error": "format_id is required in manifest"})
+
+ fmt = get_format_by_id(format_id)
+ if not fmt:
+ return json.dumps({"error": f"Format {format_id} not found"})
+
+ # Generate preview ID
+ preview_id = str(uuid.uuid4())
+
+ # Build iframe HTML based on format type
+ if fmt.type == "display":
+ width = manifest.get("width", fmt.width or 300)
+ height = manifest.get("height", fmt.height or 250)
+ image_url = manifest.get("assets", {}).get("image", "")
+ click_url = manifest.get("assets", {}).get("click_url", "#")
+
+ iframe_html = f"""
+
+""".strip()
+
+ elif fmt.type == "video":
+ width = manifest.get("width", fmt.width or 640)
+ height = manifest.get("height", fmt.height or 360)
+ video_url = manifest.get("assets", {}).get("video", "")
+
+ iframe_html = f"""
+
+""".strip()
+
+ else:
+ # Generic HTML preview
+ iframe_html = f"Preview for {fmt.name} (format_id: {format_id})
"
+
+ response = {
+ "preview_id": preview_id,
+ "format_id": format_id,
+ "preview_url": f"https://preview.adcp.example.com/{preview_id}",
+ "iframe_html": iframe_html,
+ "manifest": manifest,
+ }
+
+ return json.dumps(response, indent=2)
+
+ except json.JSONDecodeError as e:
+ return json.dumps({"error": f"Invalid JSON: {e!s}"})
+ except Exception as e:
+ return json.dumps({"error": str(e)})
diff --git a/mypy.ini b/mypy.ini
new file mode 100644
index 0000000..aa80750
--- /dev/null
+++ b/mypy.ini
@@ -0,0 +1,55 @@
+[mypy]
+python_version = 3.12
+
+# Strict mode - enable all strictness flags
+strict = True
+
+# Explicitly set strict flags (for documentation)
+warn_return_any = True
+warn_unused_configs = True
+disallow_untyped_defs = True
+disallow_incomplete_defs = True
+check_untyped_defs = True
+disallow_untyped_decorators = True
+no_implicit_optional = True
+warn_redundant_casts = True
+warn_unused_ignores = True
+warn_unreachable = True
+strict_equality = True
+strict_concatenate = True
+
+# Still useful to ignore missing imports for untyped libraries
+ignore_missing_imports = True
+
+# Error display
+show_error_codes = True
+show_column_numbers = True
+show_error_context = True
+pretty = True
+
+# Performance
+incremental = True
+cache_dir = .mypy_cache
+
+# Exclude patterns
+exclude = (?x)(
+ ^\.venv/
+ | ^venv/
+ | ^build/
+ | ^dist/
+ | ^\.git/
+ | ^__pycache__/
+ | \.pyc$
+ )
+
+# Per-module settings - keep tests less strict
+[mypy-tests.*]
+disallow_untyped_defs = False
+disallow_incomplete_defs = False
+
+# FastAPI and FastMCP decorators are untyped - allow untyped decorators for these files
+[mypy-creative_agent.api_server]
+disallow_untyped_decorators = False
+
+[mypy-creative_agent.server]
+disallow_untyped_decorators = False
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..245d1a4
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,118 @@
+[project]
+name = "adcp-creative-agent"
+version = "0.1.0"
+description = "AdCP Creative Agent - stateless MCP server for creative formats"
+readme = "README.md"
+requires-python = ">=3.12"
+
+dependencies = [
+ "fastmcp>=2.11.0",
+ "google-genai>=1.0.0",
+ "pillow>=10.0.0",
+ "fastapi>=0.100.0",
+ "uvicorn>=0.23.0",
+ "httpx>=0.28.1",
+ "pydantic>=2.0.0",
+ "boto3>=1.35.0",
+]
+
+[project.scripts]
+adcp-creative-agent = "creative_agent.server:mcp.run"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/creative_agent"]
+
+[tool.uv]
+package = true
+
+[dependency-groups]
+dev = [
+ "mypy>=1.18.2",
+ "pytest>=8.4.1",
+ "pytest-asyncio>=1.1.0",
+ "pytest-cov>=6.2.1",
+ "pytest-mock>=3.14.1",
+ "ruff>=0.8.0",
+ # Type stubs
+ "boto3-stubs[s3]>=1.35.0",
+ "types-pillow>=10.0.0",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py312"
+exclude = [
+ ".eggs",
+ ".git",
+ ".mypy_cache",
+ ".venv",
+ "build",
+ "dist",
+]
+
+[tool.ruff.lint]
+select = [
+ "E", # pycodestyle errors
+ "W", # pycodestyle warnings
+ "F", # pyflakes
+ "I", # isort
+ "B", # flake8-bugbear
+ "C4", # flake8-comprehensions
+ "UP", # pyupgrade
+ "ANN", # flake8-annotations (type hints)
+ "ASYNC",# flake8-async
+ "S", # flake8-bandit (security)
+ "BLE", # flake8-blind-except
+ "A", # flake8-builtins
+ "COM", # flake8-commas
+ "DTZ", # flake8-datetimez
+ "T10", # flake8-debugger
+ "ISC", # flake8-implicit-str-concat
+ "PIE", # flake8-pie
+ "PT", # flake8-pytest-style
+ "Q", # flake8-quotes
+ "RSE", # flake8-raise
+ "RET", # flake8-return
+ "SIM", # flake8-simplify
+ "TCH", # flake8-type-checking
+ "PTH", # flake8-use-pathlib
+ "ERA", # eradicate (commented code)
+ "PL", # pylint
+ "RUF", # ruff-specific rules
+]
+ignore = [
+ "E501", # line too long (handled by formatter)
+ "ANN101", # missing-type-self (deprecated)
+ "ANN102", # missing-type-cls (deprecated)
+ "ANN401", # any-type (sometimes necessary)
+ "COM812", # trailing comma (conflicts with formatter)
+ "ISC001", # implicit str concat (conflicts with formatter)
+ "BLE001", # blind except (acceptable for tool error handling)
+ "S104", # hardcoded bind all interfaces (required for production deployment)
+ "A002", # argument shadows builtin (type parameter name is intentional)
+ "PLR0911", # too many return statements (acceptable for validation logic)
+ "PLR0912", # too many branches (acceptable for complex generation logic)
+ "PLR0913", # too many arguments (acceptable for MCP tool signatures)
+ "PLR0915", # too many statements (acceptable for generation logic)
+ "PLR2004", # magic value (acceptable for dimension parsing)
+ "PLC0415", # import outside top-level (acceptable for lazy imports)
+ "SIM108", # ternary operator (if-else is more readable)
+ "SIM102", # nested if (nested is more readable)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = [
+ "S101", # assert used (normal in tests)
+ "ANN", # type annotations (less strict in tests)
+ "PLR2004", # magic values (ok in tests)
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
diff --git a/pytest.ini b/pytest.ini
new file mode 100644
index 0000000..952cf79
--- /dev/null
+++ b/pytest.ini
@@ -0,0 +1,46 @@
+[pytest]
+# Test discovery
+testpaths = tests
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*
+
+# Output options
+addopts =
+ -p pytest_mock
+ -v
+ --tb=short
+ --strict-markers
+ --cov=src/creative_agent
+ --cov-report=term-missing:skip-covered
+ --cov-report=html
+ --cov-report=json
+ --cov-fail-under=10
+
+# Markers
+markers =
+ smoke: Critical path tests that MUST always pass
+ unit: Fast, isolated unit tests
+ integration: Tests requiring services
+ slow: Tests that take > 5 seconds
+ ai: Tests requiring AI API keys
+ asyncio: Async test functions
+
+# Ignore patterns
+norecursedirs = .git .venv tools scripts
+
+# Asyncio mode
+asyncio_mode = auto
+
+[coverage:run]
+branch = True
+source = src/creative_agent
+omit =
+ tests/*
+ */__pycache__/*
+ */.venv/*
+
+[coverage:report]
+precision = 2
+show_missing = True
+skip_covered = False
diff --git a/src/creative_agent/__init__.py b/src/creative_agent/__init__.py
new file mode 100644
index 0000000..ffea511
--- /dev/null
+++ b/src/creative_agent/__init__.py
@@ -0,0 +1,3 @@
+"""AdCP Creative Agent - Stateless MCP server for creative formats."""
+
+__version__ = "0.1.0"
diff --git a/src/creative_agent/api_server.py b/src/creative_agent/api_server.py
new file mode 100644
index 0000000..01774ae
--- /dev/null
+++ b/src/creative_agent/api_server.py
@@ -0,0 +1,125 @@
+"""FastAPI HTTP server for AdCP Creative Agent (Fly.io deployment)."""
+
+import os
+import uuid
+from typing import Any
+
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from pydantic import BaseModel
+
+from .data.formats import STANDARD_FORMATS, get_format_by_id
+
+app = FastAPI(title="AdCP Creative Agent", version="1.0.0")
+
+# Enable CORS
+app.add_middleware(
+ CORSMiddleware,
+ allow_origins=["*"],
+ allow_credentials=True,
+ allow_methods=["*"],
+ allow_headers=["*"],
+)
+
+
+class PreviewRequest(BaseModel):
+ """Request to generate creative preview."""
+
+ format_id: str
+ width: int | None = None
+ height: int | None = None
+ assets: dict[str, Any]
+
+
+@app.get("/")
+async def root() -> dict[str, Any]:
+ """Root endpoint."""
+ return {
+ "name": "AdCP Creative Agent",
+ "version": "1.0.0",
+ "endpoints": {
+ "formats": "/formats",
+ "preview": "/preview (POST)",
+ },
+ }
+
+
+@app.get("/health")
+async def health() -> dict[str, str]:
+ """Health check endpoint."""
+ return {"status": "ok"}
+
+
+@app.get("/formats")
+async def list_formats() -> list[dict[str, Any]]:
+ """List all available creative formats."""
+ return [fmt.model_dump() for fmt in STANDARD_FORMATS]
+
+
+@app.get("/formats/{format_id}")
+async def get_format(format_id: str) -> dict[str, Any]:
+ """Get a specific format."""
+ fmt = get_format_by_id(format_id)
+ if not fmt:
+ raise HTTPException(status_code=404, detail=f"Format {format_id} not found")
+ result: dict[str, Any] = fmt.model_dump()
+ return result
+
+
+@app.post("/preview")
+async def preview_creative(request: PreviewRequest) -> dict[str, Any]:
+ """Generate preview from creative manifest."""
+ # Validate format exists
+ fmt = get_format_by_id(request.format_id)
+ if not fmt:
+ raise HTTPException(status_code=404, detail=f"Format {request.format_id} not found")
+
+ # Generate preview ID
+ preview_id = str(uuid.uuid4())
+
+ # Build iframe HTML based on format type
+ if fmt.type == "display":
+ width = request.width or fmt.width or 300
+ height = request.height or fmt.height or 250
+ image_url = request.assets.get("image", "")
+ click_url = request.assets.get("click_url", "#")
+
+ iframe_html = f"""
+
+""".strip()
+
+ elif fmt.type == "video":
+ width = request.width or fmt.width or 640
+ height = request.height or fmt.height or 360
+ video_url = request.assets.get("video", "")
+
+ iframe_html = f"""
+
+""".strip()
+
+ else:
+ # Generic HTML preview
+ iframe_html = f"Preview for {fmt.name} (format_id: {request.format_id})
"
+
+ return {
+ "preview_id": preview_id,
+ "format_id": request.format_id,
+ "preview_url": f"https://creative.adcontextprotocol.org/previews/{preview_id}",
+ "iframe_html": iframe_html,
+ "manifest": request.model_dump(),
+ }
+
+
+if __name__ == "__main__":
+ import uvicorn
+
+ port = int(os.getenv("PORT", "8080"))
+ uvicorn.run(app, host="0.0.0.0", port=port)
diff --git a/src/creative_agent/data/standard_formats.py b/src/creative_agent/data/standard_formats.py
new file mode 100644
index 0000000..4b28d9a
--- /dev/null
+++ b/src/creative_agent/data/standard_formats.py
@@ -0,0 +1,1150 @@
+"""Standard AdCP creative formats."""
+
+from ..schemas.format import AssetRequirement, CreativeFormat, FormatRequirements
+
+# Agent configuration
+AGENT_URL = "https://creative.adcontextprotocol.org"
+AGENT_NAME = "AdCP Standard Creative Agent"
+AGENT_CAPABILITIES = ["validation", "assembly", "generation", "preview"]
+
+# Common macros supported across all formats
+COMMON_MACROS = [
+ "MEDIA_BUY_ID",
+ "CREATIVE_ID",
+ "CACHEBUSTER",
+ "CLICK_URL",
+ "IMPRESSION_URL",
+ "DEVICE_TYPE",
+ "GDPR",
+ "GDPR_CONSENT",
+ "US_PRIVACY",
+ "GPP_STRING",
+]
+
+# Generative Formats - AI-powered creative generation
+GENERATIVE_FORMATS = [
+ CreativeFormat(
+ format_id="display_300x250_generative",
+ agent_url=AGENT_URL,
+ name="Medium Rectangle - AI Generated",
+ type="generative",
+ category="generative",
+ is_standard=False,
+ description="AI-generated 300x250 banner from brand context and prompt",
+ dimensions="300x250",
+ output_format="display_300x250_image",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="brand_context",
+ asset_type="promoted_offerings",
+ required=True,
+ description="Brand information and product offerings for AI generation",
+ ),
+ AssetRequirement(
+ asset_role="generation_prompt",
+ asset_type="text",
+ required=True,
+ description="Text prompt describing the desired creative",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_728x90_generative",
+ agent_url=AGENT_URL,
+ name="Leaderboard - AI Generated",
+ type="generative",
+ category="generative",
+ is_standard=False,
+ description="AI-generated 728x90 banner from brand context and prompt",
+ dimensions="728x90",
+ output_format="display_728x90_image",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="brand_context",
+ asset_type="promoted_offerings",
+ required=True,
+ description="Brand information and product offerings for AI generation",
+ ),
+ AssetRequirement(
+ asset_role="generation_prompt",
+ asset_type="text",
+ required=True,
+ description="Text prompt describing the desired creative",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_320x50_generative",
+ agent_url=AGENT_URL,
+ name="Mobile Banner - AI Generated",
+ type="generative",
+ category="generative",
+ is_standard=False,
+ description="AI-generated 320x50 mobile banner from brand context and prompt",
+ dimensions="320x50",
+ output_format="display_320x50_image",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="brand_context",
+ asset_type="promoted_offerings",
+ required=True,
+ description="Brand information and product offerings for AI generation",
+ ),
+ AssetRequirement(
+ asset_role="generation_prompt",
+ asset_type="text",
+ required=True,
+ description="Text prompt describing the desired creative",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_160x600_generative",
+ agent_url=AGENT_URL,
+ name="Wide Skyscraper - AI Generated",
+ type="generative",
+ category="generative",
+ is_standard=False,
+ description="AI-generated 160x600 wide skyscraper from brand context and prompt",
+ dimensions="160x600",
+ output_format="display_160x600_image",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="brand_context",
+ asset_type="promoted_offerings",
+ required=True,
+ description="Brand information and product offerings for AI generation",
+ ),
+ AssetRequirement(
+ asset_role="generation_prompt",
+ asset_type="text",
+ required=True,
+ description="Text prompt describing the desired creative",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_336x280_generative",
+ agent_url=AGENT_URL,
+ name="Large Rectangle - AI Generated",
+ type="generative",
+ category="generative",
+ is_standard=False,
+ description="AI-generated 336x280 large rectangle from brand context and prompt",
+ dimensions="336x280",
+ output_format="display_336x280_image",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="brand_context",
+ asset_type="promoted_offerings",
+ required=True,
+ description="Brand information and product offerings for AI generation",
+ ),
+ AssetRequirement(
+ asset_role="generation_prompt",
+ asset_type="text",
+ required=True,
+ description="Text prompt describing the desired creative",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_300x600_generative",
+ agent_url=AGENT_URL,
+ name="Half Page - AI Generated",
+ type="generative",
+ category="generative",
+ is_standard=False,
+ description="AI-generated 300x600 half page from brand context and prompt",
+ dimensions="300x600",
+ output_format="display_300x600_image",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="brand_context",
+ asset_type="promoted_offerings",
+ required=True,
+ description="Brand information and product offerings for AI generation",
+ ),
+ AssetRequirement(
+ asset_role="generation_prompt",
+ asset_type="text",
+ required=True,
+ description="Text prompt describing the desired creative",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_970x250_generative",
+ agent_url=AGENT_URL,
+ name="Billboard - AI Generated",
+ type="generative",
+ category="generative",
+ is_standard=False,
+ description="AI-generated 970x250 billboard from brand context and prompt",
+ dimensions="970x250",
+ output_format="display_970x250_image",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="brand_context",
+ asset_type="promoted_offerings",
+ required=True,
+ description="Brand information and product offerings for AI generation",
+ ),
+ AssetRequirement(
+ asset_role="generation_prompt",
+ asset_type="text",
+ required=True,
+ description="Text prompt describing the desired creative",
+ ),
+ ],
+ ),
+]
+
+# Video Formats
+VIDEO_FORMATS = [
+ CreativeFormat(
+ format_id="video_standard_30s",
+ agent_url=AGENT_URL,
+ name="Standard Video - 30 seconds",
+ type="video",
+ category="standard",
+ is_standard=True,
+ description="30-second video ad in standard aspect ratios",
+ iab_specification="https://iabtechlab.com/standards/video-ad-serving-template-vast/",
+ accepts_3p_tags=True,
+ supported_macros=[*COMMON_MACROS, "VIDEO_ID", "POD_POSITION", "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ duration_seconds=30,
+ max_file_size_mb=50,
+ acceptable_formats=["mp4", "mov", "webm"],
+ aspect_ratios=["16:9", "9:16", "1:1", "4:5"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="video_file",
+ asset_type="video",
+ required=True,
+ duration_seconds=30,
+ acceptable_formats=["mp4", "mov", "webm"],
+ description="30-second video file",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="video_standard_15s",
+ agent_url=AGENT_URL,
+ name="Standard Video - 15 seconds",
+ type="video",
+ category="standard",
+ is_standard=True,
+ description="15-second video ad in standard aspect ratios",
+ iab_specification="https://iabtechlab.com/standards/video-ad-serving-template-vast/",
+ accepts_3p_tags=True,
+ supported_macros=[*COMMON_MACROS, "VIDEO_ID", "POD_POSITION", "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ duration_seconds=15,
+ max_file_size_mb=25,
+ acceptable_formats=["mp4", "mov", "webm"],
+ aspect_ratios=["16:9", "9:16", "1:1", "4:5"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="video_file",
+ asset_type="video",
+ required=True,
+ duration_seconds=15,
+ acceptable_formats=["mp4", "mov", "webm"],
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="video_vast_30s",
+ agent_url=AGENT_URL,
+ name="VAST Video - 30 seconds",
+ type="video",
+ category="standard",
+ is_standard=True,
+ description="30-second video ad via VAST tag",
+ iab_specification="https://iabtechlab.com/standards/video-ad-serving-template-vast/",
+ accepts_3p_tags=True,
+ supported_macros=[*COMMON_MACROS, "VIDEO_ID", "POD_POSITION", "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ duration_seconds=30,
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="vast_tag",
+ asset_type="vast_tag",
+ required=True,
+ description="VAST 4.x compatible tag",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="video_1920x1080",
+ agent_url=AGENT_URL,
+ name="Full HD Video - 1920x1080",
+ type="video",
+ category="standard",
+ is_standard=True,
+ description="1920x1080 Full HD video (16:9)",
+ dimensions="1920x1080",
+ iab_specification="https://iabtechlab.com/standards/video-ad-serving-template-vast/",
+ accepts_3p_tags=False,
+ supported_macros=[*COMMON_MACROS, "VIDEO_ID", "POD_POSITION", "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ max_file_size_mb=100,
+ acceptable_formats=["mp4", "mov", "webm"],
+ aspect_ratios=["16:9"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="video_file",
+ asset_type="video",
+ required=True,
+ width=1920,
+ height=1080,
+ acceptable_formats=["mp4", "mov", "webm"],
+ description="1920x1080 video file",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="video_1280x720",
+ agent_url=AGENT_URL,
+ name="HD Video - 1280x720",
+ type="video",
+ category="standard",
+ is_standard=True,
+ description="1280x720 HD video (16:9)",
+ dimensions="1280x720",
+ iab_specification="https://iabtechlab.com/standards/video-ad-serving-template-vast/",
+ accepts_3p_tags=False,
+ supported_macros=[*COMMON_MACROS, "VIDEO_ID", "POD_POSITION", "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ max_file_size_mb=75,
+ acceptable_formats=["mp4", "mov", "webm"],
+ aspect_ratios=["16:9"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="video_file",
+ asset_type="video",
+ required=True,
+ width=1280,
+ height=720,
+ acceptable_formats=["mp4", "mov", "webm"],
+ description="1280x720 video file",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="video_1080x1920",
+ agent_url=AGENT_URL,
+ name="Vertical Video - 1080x1920",
+ type="video",
+ category="standard",
+ is_standard=True,
+ description="1080x1920 vertical video (9:16) for mobile stories",
+ dimensions="1080x1920",
+ iab_specification="https://iabtechlab.com/standards/video-ad-serving-template-vast/",
+ accepts_3p_tags=False,
+ supported_macros=[*COMMON_MACROS, "VIDEO_ID", "POD_POSITION", "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ max_file_size_mb=100,
+ acceptable_formats=["mp4", "mov", "webm"],
+ aspect_ratios=["9:16"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="video_file",
+ asset_type="video",
+ required=True,
+ width=1080,
+ height=1920,
+ acceptable_formats=["mp4", "mov", "webm"],
+ description="1080x1920 vertical video file",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="video_1080x1080",
+ agent_url=AGENT_URL,
+ name="Square Video - 1080x1080",
+ type="video",
+ category="standard",
+ is_standard=True,
+ description="1080x1080 square video (1:1) for social feeds",
+ dimensions="1080x1080",
+ iab_specification="https://iabtechlab.com/standards/video-ad-serving-template-vast/",
+ accepts_3p_tags=False,
+ supported_macros=[*COMMON_MACROS, "VIDEO_ID", "POD_POSITION", "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ max_file_size_mb=100,
+ acceptable_formats=["mp4", "mov", "webm"],
+ aspect_ratios=["1:1"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="video_file",
+ asset_type="video",
+ required=True,
+ width=1080,
+ height=1080,
+ acceptable_formats=["mp4", "mov", "webm"],
+ description="1080x1080 square video file",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="video_ctv_preroll_30s",
+ agent_url=AGENT_URL,
+ name="CTV Pre-Roll - 30 seconds",
+ type="video",
+ category="standard",
+ is_standard=True,
+ description="30-second pre-roll ad for Connected TV and streaming platforms",
+ iab_specification="https://iabtechlab.com/standards/video-ad-serving-template-vast/",
+ accepts_3p_tags=True,
+ supported_macros=[*COMMON_MACROS, "VIDEO_ID", "POD_POSITION", "CONTENT_GENRE", "PLAYER_SIZE"],
+ requirements=FormatRequirements(
+ duration_seconds=30,
+ max_file_size_mb=75,
+ acceptable_formats=["mp4", "mov"],
+ aspect_ratios=["16:9"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="video_file",
+ asset_type="video",
+ required=True,
+ duration_seconds=30,
+ acceptable_formats=["mp4", "mov"],
+ description="30-second CTV-optimized video file (1920x1080 recommended)",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="video_ctv_midroll_30s",
+ agent_url=AGENT_URL,
+ name="CTV Mid-Roll - 30 seconds",
+ type="video",
+ category="standard",
+ is_standard=True,
+ description="30-second mid-roll ad for Connected TV and streaming platforms",
+ iab_specification="https://iabtechlab.com/standards/video-ad-serving-template-vast/",
+ accepts_3p_tags=True,
+ supported_macros=[*COMMON_MACROS, "VIDEO_ID", "POD_POSITION", "CONTENT_GENRE", "PLAYER_SIZE"],
+ requirements=FormatRequirements(
+ duration_seconds=30,
+ max_file_size_mb=75,
+ acceptable_formats=["mp4", "mov"],
+ aspect_ratios=["16:9"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="video_file",
+ asset_type="video",
+ required=True,
+ duration_seconds=30,
+ acceptable_formats=["mp4", "mov"],
+ description="30-second CTV-optimized video file (1920x1080 recommended)",
+ ),
+ ],
+ ),
+]
+
+# Display Formats - Image-based
+DISPLAY_IMAGE_FORMATS = [
+ CreativeFormat(
+ format_id="display_300x250_image",
+ agent_url=AGENT_URL,
+ name="Medium Rectangle - Image",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="300x250 static image banner",
+ dimensions="300x250",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="banner_image",
+ asset_type="image",
+ required=True,
+ width=300,
+ height=250,
+ max_file_size_mb=0.2, # 200kb
+ acceptable_formats=["jpg", "png", "gif", "webp"],
+ ),
+ AssetRequirement(
+ asset_role="click_url",
+ asset_type="url",
+ required=True,
+ description="Clickthrough destination URL",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_728x90_image",
+ agent_url=AGENT_URL,
+ name="Leaderboard - Image",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="728x90 static image banner",
+ dimensions="728x90",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="banner_image",
+ asset_type="image",
+ required=True,
+ width=728,
+ height=90,
+ max_file_size_mb=0.15,
+ acceptable_formats=["jpg", "png", "gif", "webp"],
+ ),
+ AssetRequirement(
+ asset_role="click_url",
+ asset_type="url",
+ required=True,
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_320x50_image",
+ agent_url=AGENT_URL,
+ name="Mobile Banner - Image",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="320x50 mobile banner",
+ dimensions="320x50",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="banner_image",
+ asset_type="image",
+ required=True,
+ width=320,
+ height=50,
+ max_file_size_mb=0.05,
+ acceptable_formats=["jpg", "png", "gif", "webp"],
+ ),
+ AssetRequirement(
+ asset_role="click_url",
+ asset_type="url",
+ required=True,
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_160x600_image",
+ agent_url=AGENT_URL,
+ name="Wide Skyscraper - Image",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="160x600 wide skyscraper banner",
+ dimensions="160x600",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="banner_image",
+ asset_type="image",
+ required=True,
+ width=160,
+ height=600,
+ max_file_size_mb=0.15,
+ acceptable_formats=["jpg", "png", "gif", "webp"],
+ ),
+ AssetRequirement(
+ asset_role="click_url",
+ asset_type="url",
+ required=True,
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_336x280_image",
+ agent_url=AGENT_URL,
+ name="Large Rectangle - Image",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="336x280 large rectangle banner",
+ dimensions="336x280",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="banner_image",
+ asset_type="image",
+ required=True,
+ width=336,
+ height=280,
+ max_file_size_mb=0.25,
+ acceptable_formats=["jpg", "png", "gif", "webp"],
+ ),
+ AssetRequirement(
+ asset_role="click_url",
+ asset_type="url",
+ required=True,
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_300x600_image",
+ agent_url=AGENT_URL,
+ name="Half Page - Image",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="300x600 half page banner",
+ dimensions="300x600",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="banner_image",
+ asset_type="image",
+ required=True,
+ width=300,
+ height=600,
+ max_file_size_mb=0.3,
+ acceptable_formats=["jpg", "png", "gif", "webp"],
+ ),
+ AssetRequirement(
+ asset_role="click_url",
+ asset_type="url",
+ required=True,
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_970x250_image",
+ agent_url=AGENT_URL,
+ name="Billboard - Image",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="970x250 billboard banner",
+ dimensions="970x250",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="banner_image",
+ asset_type="image",
+ required=True,
+ width=970,
+ height=250,
+ max_file_size_mb=0.4,
+ acceptable_formats=["jpg", "png", "gif", "webp"],
+ ),
+ AssetRequirement(
+ asset_role="click_url",
+ asset_type="url",
+ required=True,
+ ),
+ ],
+ ),
+]
+
+# Display Formats - HTML5
+DISPLAY_HTML_FORMATS = [
+ CreativeFormat(
+ format_id="display_300x250_html",
+ agent_url=AGENT_URL,
+ name="Medium Rectangle - HTML5",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="300x250 HTML5 creative",
+ dimensions="300x250",
+ accepts_3p_tags=True,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="html_creative",
+ asset_type="html",
+ required=True,
+ width=300,
+ height=250,
+ max_file_size_mb=0.5,
+ description="HTML5 creative code",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_728x90_html",
+ agent_url=AGENT_URL,
+ name="Leaderboard - HTML5",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="728x90 HTML5 creative",
+ dimensions="728x90",
+ accepts_3p_tags=True,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="html_creative",
+ asset_type="html",
+ required=True,
+ width=728,
+ height=90,
+ max_file_size_mb=0.5,
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_160x600_html",
+ agent_url=AGENT_URL,
+ name="Wide Skyscraper - HTML5",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="160x600 HTML5 creative",
+ dimensions="160x600",
+ accepts_3p_tags=True,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="html_creative",
+ asset_type="html",
+ required=True,
+ width=160,
+ height=600,
+ max_file_size_mb=0.5,
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_336x280_html",
+ agent_url=AGENT_URL,
+ name="Large Rectangle - HTML5",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="336x280 HTML5 creative",
+ dimensions="336x280",
+ accepts_3p_tags=True,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="html_creative",
+ asset_type="html",
+ required=True,
+ width=336,
+ height=280,
+ max_file_size_mb=0.5,
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_300x600_html",
+ agent_url=AGENT_URL,
+ name="Half Page - HTML5",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="300x600 HTML5 creative",
+ dimensions="300x600",
+ accepts_3p_tags=True,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="html_creative",
+ asset_type="html",
+ required=True,
+ width=300,
+ height=600,
+ max_file_size_mb=0.5,
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="display_970x250_html",
+ agent_url=AGENT_URL,
+ name="Billboard - HTML5",
+ type="display",
+ category="standard",
+ is_standard=True,
+ description="970x250 HTML5 creative",
+ dimensions="970x250",
+ accepts_3p_tags=True,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="html_creative",
+ asset_type="html",
+ required=True,
+ width=970,
+ height=250,
+ max_file_size_mb=0.5,
+ ),
+ ],
+ ),
+]
+
+# Native Formats
+NATIVE_FORMATS = [
+ CreativeFormat(
+ format_id="native_standard",
+ agent_url=AGENT_URL,
+ name="IAB Native Standard",
+ type="native",
+ category="standard",
+ is_standard=True,
+ description="Standard native ad with title, description, image, and CTA",
+ iab_specification="https://iabtechlab.com/standards/openrtb-native/",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="title",
+ asset_type="text",
+ required=True,
+ description="Headline text (25 chars recommended)",
+ ),
+ AssetRequirement(
+ asset_role="description",
+ asset_type="text",
+ required=True,
+ description="Body copy (90 chars recommended)",
+ ),
+ AssetRequirement(
+ asset_role="main_image",
+ asset_type="image",
+ required=True,
+ description="Primary image (1200x627 recommended)",
+ ),
+ AssetRequirement(
+ asset_role="icon",
+ asset_type="image",
+ required=False,
+ description="Brand icon (square, 200x200 recommended)",
+ ),
+ AssetRequirement(
+ asset_role="cta_text",
+ asset_type="text",
+ required=True,
+ description="Call-to-action text",
+ ),
+ AssetRequirement(
+ asset_role="sponsored_by",
+ asset_type="text",
+ required=True,
+ description="Advertiser name for disclosure",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="native_content",
+ agent_url=AGENT_URL,
+ name="Native Content Placement",
+ type="native",
+ category="standard",
+ is_standard=True,
+ description="In-article native ad with editorial styling",
+ iab_specification="https://iabtechlab.com/standards/openrtb-native/",
+ accepts_3p_tags=False,
+ supported_macros=COMMON_MACROS,
+ assets_required=[
+ AssetRequirement(
+ asset_role="headline",
+ asset_type="text",
+ required=True,
+ description="Editorial-style headline (60 chars recommended)",
+ ),
+ AssetRequirement(
+ asset_role="body",
+ asset_type="text",
+ required=True,
+ description="Article-style body copy (200 chars recommended)",
+ ),
+ AssetRequirement(
+ asset_role="thumbnail",
+ asset_type="image",
+ required=True,
+ description="Thumbnail image (square, 300x300 recommended)",
+ ),
+ AssetRequirement(
+ asset_role="author",
+ asset_type="text",
+ required=False,
+ description="Author name for editorial context",
+ ),
+ AssetRequirement(
+ asset_role="click_url",
+ asset_type="url",
+ required=True,
+ description="Landing page URL",
+ ),
+ AssetRequirement(
+ asset_role="disclosure",
+ asset_type="text",
+ required=True,
+ description="Sponsored content disclosure text",
+ ),
+ ],
+ ),
+]
+
+# Audio Formats
+AUDIO_FORMATS = [
+ CreativeFormat(
+ format_id="audio_standard_15s",
+ agent_url=AGENT_URL,
+ name="Standard Audio - 15 seconds",
+ type="audio",
+ category="standard",
+ is_standard=True,
+ description="15-second audio ad",
+ accepts_3p_tags=True,
+ supported_macros=[*COMMON_MACROS, "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ duration_seconds=15,
+ max_file_size_mb=0.75,
+ acceptable_formats=["mp3", "aac", "m4a"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="audio_file",
+ asset_type="audio",
+ required=True,
+ duration_seconds=15,
+ acceptable_formats=["mp3", "aac", "m4a"],
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="audio_standard_30s",
+ agent_url=AGENT_URL,
+ name="Standard Audio - 30 seconds",
+ type="audio",
+ category="standard",
+ is_standard=True,
+ description="30-second audio ad",
+ accepts_3p_tags=True,
+ supported_macros=[*COMMON_MACROS, "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ duration_seconds=30,
+ max_file_size_mb=1.5,
+ acceptable_formats=["mp3", "aac", "m4a"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="audio_file",
+ asset_type="audio",
+ required=True,
+ duration_seconds=30,
+ acceptable_formats=["mp3", "aac", "m4a"],
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="audio_standard_60s",
+ agent_url=AGENT_URL,
+ name="Standard Audio - 60 seconds",
+ type="audio",
+ category="standard",
+ is_standard=True,
+ description="60-second audio ad",
+ accepts_3p_tags=True,
+ supported_macros=[*COMMON_MACROS, "CONTENT_GENRE"],
+ requirements=FormatRequirements(
+ duration_seconds=60,
+ max_file_size_mb=3,
+ acceptable_formats=["mp3", "aac", "m4a"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="audio_file",
+ asset_type="audio",
+ required=True,
+ duration_seconds=60,
+ acceptable_formats=["mp3", "aac", "m4a"],
+ ),
+ ],
+ ),
+]
+
+# DOOH Formats
+DOOH_FORMATS = [
+ CreativeFormat(
+ format_id="dooh_billboard_1920x1080",
+ agent_url=AGENT_URL,
+ name="Digital Billboard - 1920x1080",
+ type="dooh",
+ category="standard",
+ is_standard=True,
+ description="Full HD digital billboard",
+ dimensions="1920x1080",
+ accepts_3p_tags=False,
+ supported_macros=[*COMMON_MACROS, "SCREEN_ID", "VENUE_TYPE", "VENUE_LAT", "VENUE_LONG"],
+ requirements=FormatRequirements(
+ duration_seconds=10, # Typical DOOH loop duration
+ max_file_size_mb=5,
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="billboard_image",
+ asset_type="image",
+ required=True,
+ width=1920,
+ height=1080,
+ acceptable_formats=["jpg", "png"],
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="dooh_billboard_landscape",
+ agent_url=AGENT_URL,
+ name="Digital Billboard - Landscape",
+ type="dooh",
+ category="standard",
+ is_standard=True,
+ description="Landscape-oriented digital billboard (various sizes)",
+ accepts_3p_tags=False,
+ supported_macros=[*COMMON_MACROS, "SCREEN_ID", "VENUE_TYPE", "VENUE_LAT", "VENUE_LONG"],
+ requirements=FormatRequirements(
+ duration_seconds=10,
+ max_file_size_mb=10,
+ aspect_ratios=["16:9", "21:9"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="billboard_image",
+ asset_type="image",
+ required=True,
+ acceptable_formats=["jpg", "png"],
+ description="Landscape image (1920x1080 or larger)",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="dooh_billboard_portrait",
+ agent_url=AGENT_URL,
+ name="Digital Billboard - Portrait",
+ type="dooh",
+ category="standard",
+ is_standard=True,
+ description="Portrait-oriented digital billboard (various sizes)",
+ accepts_3p_tags=False,
+ supported_macros=[*COMMON_MACROS, "SCREEN_ID", "VENUE_TYPE", "VENUE_LAT", "VENUE_LONG"],
+ requirements=FormatRequirements(
+ duration_seconds=10,
+ max_file_size_mb=10,
+ aspect_ratios=["9:16"],
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="billboard_image",
+ asset_type="image",
+ required=True,
+ acceptable_formats=["jpg", "png"],
+ description="Portrait image (1080x1920 or similar)",
+ ),
+ ],
+ ),
+ CreativeFormat(
+ format_id="dooh_transit_screen",
+ agent_url=AGENT_URL,
+ name="Transit Screen",
+ type="dooh",
+ category="standard",
+ is_standard=True,
+ description="Transit and subway screen displays",
+ dimensions="1920x1080",
+ accepts_3p_tags=False,
+ supported_macros=[*COMMON_MACROS, "SCREEN_ID", "VENUE_TYPE", "VENUE_LAT", "VENUE_LONG", "TRANSIT_LINE"],
+ requirements=FormatRequirements(
+ duration_seconds=15, # Longer dwell time in transit
+ max_file_size_mb=5,
+ ),
+ assets_required=[
+ AssetRequirement(
+ asset_role="screen_image",
+ asset_type="image",
+ required=True,
+ width=1920,
+ height=1080,
+ acceptable_formats=["jpg", "png"],
+ description="Transit screen content",
+ ),
+ ],
+ ),
+]
+
+# Combine all formats
+STANDARD_FORMATS = (
+ GENERATIVE_FORMATS
+ + VIDEO_FORMATS
+ + DISPLAY_IMAGE_FORMATS
+ + DISPLAY_HTML_FORMATS
+ + NATIVE_FORMATS
+ + AUDIO_FORMATS
+ + DOOH_FORMATS
+)
+
+
+def get_format_by_id(format_id: str) -> CreativeFormat | None:
+ """Get format by ID."""
+ for fmt in STANDARD_FORMATS:
+ if fmt.format_id == format_id:
+ return fmt
+ return None
+
+
+def filter_formats(
+ format_ids: list[str] | None = None,
+ type: str | None = None,
+ asset_types: list[str] | None = None,
+ dimensions: str | None = None,
+ name_search: str | None = None,
+) -> list[CreativeFormat]:
+ """Filter formats based on criteria."""
+ results = STANDARD_FORMATS
+
+ if format_ids:
+ results = [fmt for fmt in results if fmt.format_id in format_ids]
+
+ if type:
+ results = [fmt for fmt in results if fmt.type == type]
+
+ if dimensions:
+ results = [fmt for fmt in results if fmt.dimensions == dimensions]
+
+ if name_search:
+ search_lower = name_search.lower()
+ results = [fmt for fmt in results if search_lower in fmt.name.lower()]
+
+ if asset_types:
+ # Filter to formats that include ALL specified asset types
+ results = [
+ fmt
+ for fmt in results
+ if all(any(req.asset_type == asset_type for req in fmt.assets_required) for asset_type in asset_types)
+ ]
+
+ return results
diff --git a/src/creative_agent/http_server.py b/src/creative_agent/http_server.py
new file mode 100644
index 0000000..4222f08
--- /dev/null
+++ b/src/creative_agent/http_server.py
@@ -0,0 +1,12 @@
+"""HTTP server for AdCP Creative Agent (for Fly.io deployment)."""
+
+import os
+
+from .server import mcp
+
+# Get port from environment (Fly.io sets this)
+PORT = int(os.getenv("PORT", "8080"))
+
+if __name__ == "__main__":
+ # Run in HTTP mode for production deployment
+ mcp.run(transport="sse", port=PORT, host="0.0.0.0")
diff --git a/src/creative_agent/schemas/__init__.py b/src/creative_agent/schemas/__init__.py
new file mode 100644
index 0000000..52f1ae6
--- /dev/null
+++ b/src/creative_agent/schemas/__init__.py
@@ -0,0 +1,54 @@
+"""AdCP schemas for creative agent."""
+
+from .assets import (
+ Asset,
+ AudioAsset,
+ HtmlAsset,
+ ImageAsset,
+ JavaScriptAsset,
+ TextAsset,
+ UrlAsset,
+ VastTagAsset,
+ VideoAsset,
+ WebhookAsset,
+)
+from .format import (
+ AssetRequirement,
+ CreativeFormat,
+ FormatRequirements,
+ ListCreativeFormatsRequest,
+ ListCreativeFormatsResponse,
+)
+from .manifest import (
+ CreativeManifest,
+ PreviewCreativeRequest,
+ PreviewCreativeResponse,
+ PreviewInput,
+ PreviewVariant,
+)
+
+__all__ = [
+ # Assets
+ "Asset",
+ "AssetRequirement",
+ "AudioAsset",
+ # Formats
+ "CreativeFormat",
+ # Manifests
+ "CreativeManifest",
+ "FormatRequirements",
+ "HtmlAsset",
+ "ImageAsset",
+ "JavaScriptAsset",
+ "ListCreativeFormatsRequest",
+ "ListCreativeFormatsResponse",
+ "PreviewCreativeRequest",
+ "PreviewCreativeResponse",
+ "PreviewInput",
+ "PreviewVariant",
+ "TextAsset",
+ "UrlAsset",
+ "VastTagAsset",
+ "VideoAsset",
+ "WebhookAsset",
+]
diff --git a/src/creative_agent/schemas/assets.py b/src/creative_agent/schemas/assets.py
new file mode 100644
index 0000000..f890ac8
--- /dev/null
+++ b/src/creative_agent/schemas/assets.py
@@ -0,0 +1,127 @@
+"""Asset type schemas for AdCP creative manifests."""
+
+from typing import Any, Literal
+
+from pydantic import BaseModel
+
+
+class ImageAsset(BaseModel):
+ """Image asset type."""
+
+ asset_type: Literal["image"] = "image"
+ url: str
+ width: int
+ height: int
+ format: str # jpg, png, gif, webp, etc.
+ file_size: int | None = None # bytes
+ alt: str | None = None
+
+
+class VideoAsset(BaseModel):
+ """Video asset type."""
+
+ asset_type: Literal["video"] = "video"
+ url: str
+ width: int
+ height: int
+ duration_seconds: int
+ format: str # mp4, mov, webm, etc.
+ codec: str | None = None # h264, h265, vp9, av1
+ bitrate_mbps: float | None = None
+ file_size: int | None = None # bytes
+
+
+class AudioAsset(BaseModel):
+ """Audio asset type."""
+
+ asset_type: Literal["audio"] = "audio"
+ url: str
+ duration_seconds: int
+ format: str # mp3, aac, wav, etc.
+ codec: str | None = None
+ bitrate_kbps: int | None = None
+ sample_rate_hz: int | None = None
+ channels: int | None = None # 1 = mono, 2 = stereo
+ file_size: int | None = None # bytes
+
+
+class VastTagAsset(BaseModel):
+ """VAST tag asset type."""
+
+ asset_type: Literal["vast_tag"] = "vast_tag"
+ content: str # VAST XML
+ vast_version: str # "2.0", "3.0", "4.0", "4.1", "4.2"
+ vpaid_enabled: bool | None = None
+ duration_seconds: int | None = None
+
+
+class TextAsset(BaseModel):
+ """Text asset type."""
+
+ asset_type: Literal["text"] = "text"
+ content: str
+ length: int | None = None # character count
+ format: Literal["plain", "html", "markdown"] | None = "plain"
+
+
+class UrlAsset(BaseModel):
+ """URL asset type (for tracking pixels, clickthrough URLs, etc.)."""
+
+ asset_type: Literal["url"] = "url"
+ url: str
+ url_purpose: str | None = None # clickthrough, impression, tracking, etc.
+
+
+class HtmlAsset(BaseModel):
+ """HTML asset type (client-side third-party tags)."""
+
+ asset_type: Literal["html"] = "html"
+ content: str | None = None # HTML content (if inline)
+ url: str | None = None # URL to HTML (if hosted)
+ width: int | None = None
+ height: int | None = None
+ file_size: int | None = None # bytes
+
+
+class JavaScriptAsset(BaseModel):
+ """JavaScript asset type (client-side third-party tags)."""
+
+ asset_type: Literal["javascript"] = "javascript"
+ content: str | None = None # JS code (if inline)
+ url: str | None = None # URL to JS file (if hosted)
+ inline: bool | None = None # Whether JS should be inlined
+
+
+class WebhookAsset(BaseModel):
+ """Webhook asset type (server-side dynamic rendering)."""
+
+ asset_type: Literal["webhook"] = "webhook"
+ url: str
+ method: Literal["GET", "POST"] | None = "POST"
+ timeout_ms: int | None = 500
+ response_type: str | None = "html" # html, json, image, etc.
+ supported_macros: list[str] | None = None
+ security: dict[str, Any] | None = None # HMAC, JWT, etc.
+ fallback_required: bool | None = True
+
+
+class PromotedOfferingsAsset(BaseModel):
+ """Promoted offerings asset type (brand context for generative creatives)."""
+
+ asset_type: Literal["promoted_offerings"] = "promoted_offerings"
+ offerings: list[dict[str, Any]] # Array of offering objects with name, description, assets
+
+
+# Union type for all asset types
+Asset = (
+ ImageAsset
+ | VideoAsset
+ | AudioAsset
+ | VastTagAsset
+ | TextAsset
+ | UrlAsset
+ | HtmlAsset
+ | JavaScriptAsset
+ | WebhookAsset
+ | PromotedOfferingsAsset
+)
diff --git a/src/creative_agent/schemas/brand_card.py b/src/creative_agent/schemas/brand_card.py
new file mode 100644
index 0000000..bbe4e06
--- /dev/null
+++ b/src/creative_agent/schemas/brand_card.py
@@ -0,0 +1,27 @@
+"""Brand card schema for AdCP creative agent."""
+
+from pydantic import BaseModel, HttpUrl
+
+
+class BrandAsset(BaseModel):
+ """Brand asset with URL and metadata."""
+
+ asset_id: str
+ asset_type: str # "image", "video", "logo", etc.
+ url: HttpUrl
+ tags: list[str] = []
+ width: int | None = None
+ height: int | None = None
+ description: str | None = None
+
+
+class BrandCard(BaseModel):
+ """Brand card containing brand identity and assets."""
+
+ brand_url: HttpUrl
+ brand_name: str | None = None
+ brand_description: str | None = None
+ assets: list[BrandAsset] = []
+ product_catalog_url: HttpUrl | None = None
+ primary_color: str | None = None
+ secondary_color: str | None = None
diff --git a/src/creative_agent/schemas/build.py b/src/creative_agent/schemas/build.py
new file mode 100644
index 0000000..053d041
--- /dev/null
+++ b/src/creative_agent/schemas/build.py
@@ -0,0 +1,62 @@
+"""Build creative schemas for AdCP."""
+
+from typing import Any, Literal
+
+from pydantic import BaseModel, HttpUrl
+
+
+class AssetReference(BaseModel):
+ """Reference to an asset library."""
+
+ library_id: str
+ asset_ids: list[str] | None = None
+ tags: list[str] | None = None
+ filters: dict[str, Any] | None = None
+
+
+class PreviewContext(BaseModel):
+ """Context for preview generation."""
+
+ name: str
+ user_data: dict[str, Any]
+
+
+class PreviewOptions(BaseModel):
+ """Preview generation options."""
+
+ contexts: list[PreviewContext] | None = None
+ template_id: str | None = None
+
+
+class BuildCreativeRequest(BaseModel):
+ """Request to build a creative (AdCP spec)."""
+
+ message: str # Creative brief or refinement instructions
+ format_id: str
+ format_source: HttpUrl | None = None
+ output_mode: Literal["manifest", "code"] = "manifest"
+ context_id: str | None = None # For iterative refinement
+ assets: list[AssetReference] = []
+ preview_options: PreviewOptions | None = None
+ finalize: bool = False
+ # User must provide their own Gemini API key
+ gemini_api_key: str | None = None
+
+
+class CreativeOutput(BaseModel):
+ """Creative output (manifest or code)."""
+
+ type: Literal["creative_manifest", "creative_code"]
+ format_id: str
+ data: dict[str, Any] # Manifest structure or code
+
+
+class BuildCreativeResponse(BaseModel):
+ """Response from build_creative (AdCP spec)."""
+
+ message: str # Agent's description
+ context_id: str
+ status: Literal["draft", "ready", "finalized"]
+ creative_output: CreativeOutput
+ preview: HttpUrl | None = None
+ refinement_suggestions: list[str] = []
diff --git a/src/creative_agent/schemas/format.py b/src/creative_agent/schemas/format.py
new file mode 100644
index 0000000..8b80669
--- /dev/null
+++ b/src/creative_agent/schemas/format.py
@@ -0,0 +1,70 @@
+"""Creative format schemas for AdCP."""
+
+from typing import Literal
+
+from pydantic import BaseModel
+
+
+class AssetRequirement(BaseModel):
+ """Requirement for a single asset in a format."""
+
+ asset_role: str # e.g., "hero_image", "headline"
+ asset_type: str # image, video, audio, text, etc.
+ required: bool = True
+ width: int | None = None
+ height: int | None = None
+ duration_seconds: int | None = None
+ max_file_size_mb: float | None = None
+ acceptable_formats: list[str] | None = None
+ description: str | None = None
+
+
+class FormatRequirements(BaseModel):
+ """Technical requirements for a format."""
+
+ duration_seconds: int | None = None
+ max_file_size_mb: float | None = None
+ acceptable_formats: list[str] | None = None
+ aspect_ratios: list[str] | None = None
+ min_bitrate_kbps: int | None = None
+ max_bitrate_kbps: int | None = None
+
+
+class CreativeFormat(BaseModel):
+ """Complete creative format definition."""
+
+ format_id: str
+ agent_url: str # Authoritative source for this format
+ name: str
+ type: Literal["video", "display", "audio", "native", "dooh", "generative"]
+ category: str | None = None # standard, custom, etc.
+ is_standard: bool | None = None
+ description: str | None = None
+ iab_specification: str | None = None # URL to IAB spec
+ accepts_3p_tags: bool | None = False
+ dimensions: str | None = None # "300x250", "728x90", etc.
+ supported_macros: list[str] | None = None
+ requirements: FormatRequirements | None = None
+ assets_required: list[AssetRequirement]
+ output_format: str | None = None # For generative formats: the format_id this produces
+
+
+class ListCreativeFormatsRequest(BaseModel):
+ """Request for list_creative_formats task."""
+
+ format_ids: list[str] | None = None
+ type: Literal["audio", "video", "display", "dooh", "native", "interactive"] | None = None
+ asset_types: list[str] | None = None
+ dimensions: str | None = None
+ name_search: str | None = None
+
+
+class ListCreativeFormatsResponse(BaseModel):
+ """Response from list_creative_formats task."""
+
+ adcp_version: str = "1.0.0"
+ agent_url: str
+ agent_name: str
+ capabilities: list[str] # validation, assembly, generation, preview
+ formats: list[CreativeFormat]
+ creative_agents: list[str] | None = None # URLs to other creative agents
diff --git a/src/creative_agent/schemas/library.py b/src/creative_agent/schemas/library.py
new file mode 100644
index 0000000..bd3b5f2
--- /dev/null
+++ b/src/creative_agent/schemas/library.py
@@ -0,0 +1,59 @@
+"""Manage creative library schemas for AdCP."""
+
+from typing import Any, Literal
+
+from pydantic import BaseModel, HttpUrl
+
+
+class AssetMetadata(BaseModel):
+ """Asset metadata."""
+
+ width: int | None = None
+ height: int | None = None
+ duration: float | None = None # seconds
+ file_size: int | None = None # bytes
+ mime_type: str | None = None
+ alt_text: str | None = None
+
+
+class Asset(BaseModel):
+ """Creative asset."""
+
+ asset_id: str | None = None # Auto-generated if not provided
+ name: str
+ type: Literal["image", "video", "audio", "text", "logo"]
+ url: HttpUrl | None = None
+ content: str | None = None # For text assets
+ metadata: AssetMetadata | None = None
+ tags: list[str] = []
+ usage_rights: Literal["unlimited", "limited", "exclusive"] | None = None
+ expires_at: str | None = None # ISO date
+
+
+class SearchFilters(BaseModel):
+ """Filters for asset search."""
+
+ type: str | None = None
+ tags: list[str] = []
+ usage_rights: str | None = None
+
+
+class ManageCreativeLibraryRequest(BaseModel):
+ """Request to manage creative library (AdCP spec)."""
+
+ action: Literal["add", "update", "remove", "list", "search"]
+ library_id: str
+ asset: Asset | None = None # Required for add/update
+ assets: list[Asset] | None = None # For bulk add
+ asset_id: str | None = None # Required for update/remove
+ tags: list[str] = [] # For filtering/updating
+ search_query: str | None = None
+ filters: SearchFilters | None = None
+
+
+class ManageCreativeLibraryResponse(BaseModel):
+ """Response from manage_creative_library (AdCP spec)."""
+
+ message: str
+ success: bool
+ result: Any # Varies by action: asset, list of assets, etc.
diff --git a/src/creative_agent/schemas/manifest.py b/src/creative_agent/schemas/manifest.py
new file mode 100644
index 0000000..df84b67
--- /dev/null
+++ b/src/creative_agent/schemas/manifest.py
@@ -0,0 +1,73 @@
+"""Creative manifest schemas for AdCP."""
+
+from typing import Any
+
+from pydantic import BaseModel
+
+from .assets import Asset
+
+
+class CreativeManifest(BaseModel):
+ """Creative manifest structure."""
+
+ format_id: str
+ promoted_offering: str | None = None # Product being advertised
+ assets: dict[str, Asset] # Keyed by asset_role
+ metadata: dict[str, Any] | None = None
+
+
+class PreviewInput(BaseModel):
+ """Input set for preview generation."""
+
+ name: str # Human-readable name
+ macros: dict[str, str] | None = None # Macro values to apply
+ context_description: str | None = None # Natural language context for AI
+
+
+class PreviewCreativeRequest(BaseModel):
+ """Request for preview_creative task."""
+
+ format_id: str
+ creative_manifest: CreativeManifest
+ inputs: list[PreviewInput] | None = None
+ template_id: str | None = None
+ brand_card: dict[str, Any] | None = None
+ promoted_products: dict[str, Any] | None = None
+ asset_filters: dict[str, Any] | None = None
+
+
+class PreviewHints(BaseModel):
+ """Optimization metadata for preview content."""
+
+ primary_media_type: str | None = None # image, video, audio
+ estimated_dimensions: dict[str, int] | None = None # width, height
+ estimated_duration_seconds: int | None = None
+ contains_audio: bool | None = None
+ requires_interaction: bool | None = None
+
+
+class PreviewEmbedding(BaseModel):
+ """Security metadata for embedding preview content."""
+
+ recommended_sandbox: str | None = None # e.g., "allow-scripts allow-same-origin"
+ requires_https: bool | None = None
+ supports_fullscreen: bool | None = None
+ csp_policy: str | None = None
+
+
+class PreviewVariant(BaseModel):
+ """A single preview variant - always returns HTML page for iframe embedding."""
+
+ preview_url: str # URL to HTML page
+ input: PreviewInput | None = None # The input set that generated this preview
+ hints: PreviewHints | None = None # Optional optimization metadata
+ embedding: PreviewEmbedding | None = None # Optional security metadata
+
+
+class PreviewCreativeResponse(BaseModel):
+ """Response from preview_creative task."""
+
+ adcp_version: str = "1.0.0"
+ previews: list[PreviewVariant]
+ interactive_url: str | None = None
+ expires_at: str | None = None # ISO 8601 timestamp
diff --git a/src/creative_agent/schemas/preview.py b/src/creative_agent/schemas/preview.py
new file mode 100644
index 0000000..556107a
--- /dev/null
+++ b/src/creative_agent/schemas/preview.py
@@ -0,0 +1,45 @@
+"""Preview creative schemas for AdCP."""
+
+from pydantic import BaseModel, HttpUrl
+
+from .brand_card import BrandCard
+
+
+class PreviewVariant(BaseModel):
+ """Request for a specific preview variant."""
+
+ variant_id: str
+ device_type: str | None = None # "desktop", "mobile", "tablet"
+ country: str | None = None
+ region: str | None = None
+ context_description: str | None = None
+ macro_values: dict[str, str] = {}
+
+
+class PreviewCreativeRequest(BaseModel):
+ """Request to preview a creative with variants."""
+
+ format_id: str
+ brand_card: BrandCard
+ promoted_products: list[str] = [] # SKUs or product IDs
+ creative_html: str | None = None # If providing existing creative
+ creative_url: HttpUrl | None = None # If creative is hosted
+ variants: list[PreviewVariant] = []
+ ai_api_key: str | None = None # For AI-generated previews
+
+
+class PreviewResponse(BaseModel):
+ """Single preview response."""
+
+ variant_id: str
+ preview_url: HttpUrl
+ preview_html: str | None = None
+ screenshot_url: HttpUrl | None = None
+ macros_applied: dict[str, str] = {}
+
+
+class PreviewCreativeResponse(BaseModel):
+ """Response with multiple preview variants."""
+
+ format_id: str
+ previews: list[PreviewResponse]
diff --git a/src/creative_agent/server.py b/src/creative_agent/server.py
new file mode 100644
index 0000000..079d4cc
--- /dev/null
+++ b/src/creative_agent/server.py
@@ -0,0 +1,596 @@
+"""AdCP Creative Agent MCP Server - Spec Compliant Implementation."""
+
+import json
+import os
+import uuid
+from datetime import UTC, datetime, timedelta
+from typing import Any
+
+from fastmcp import FastMCP
+
+from .data.standard_formats import (
+ AGENT_CAPABILITIES,
+ AGENT_NAME,
+ AGENT_URL,
+ filter_formats,
+ get_format_by_id,
+)
+from .schemas.build import BuildCreativeRequest, BuildCreativeResponse, CreativeOutput
+from .schemas.format import ListCreativeFormatsResponse
+from .schemas.manifest import PreviewCreativeRequest, PreviewCreativeResponse, PreviewVariant
+
+mcp = FastMCP("adcp-creative-agent")
+
+
+@mcp.tool()
+def list_creative_formats(
+ format_ids: list[str] | None = None,
+ type: str | None = None,
+ asset_types: list[str] | None = None,
+ dimensions: str | None = None,
+ name_search: str | None = None,
+) -> str:
+ """List all available AdCP creative formats with optional filtering.
+
+ Args:
+ format_ids: Return only these specific format IDs
+ type: Filter by format type (audio, video, display, dooh, native, interactive)
+ asset_types: Filter to formats that include these asset types
+ dimensions: Filter to formats with specific dimensions (e.g., "300x250")
+ name_search: Search for formats by name (case-insensitive partial match)
+
+ Returns:
+ JSON string with format list response
+ """
+ try:
+ formats = filter_formats(
+ format_ids=format_ids,
+ type=type,
+ asset_types=asset_types,
+ dimensions=dimensions,
+ name_search=name_search,
+ )
+
+ response = ListCreativeFormatsResponse(
+ agent_url=AGENT_URL,
+ agent_name=AGENT_NAME,
+ capabilities=AGENT_CAPABILITIES,
+ formats=formats,
+ )
+
+ return response.model_dump_json(indent=2)
+ except Exception as e:
+ return json.dumps({"error": str(e)})
+
+
+@mcp.tool()
+def preview_creative(
+ format_id: str,
+ creative_manifest: dict[str, Any],
+ inputs: list[dict[str, Any]] | None = None,
+ template_id: str | None = None,
+ brand_card: dict[str, Any] | None = None,
+ promoted_products: dict[str, Any] | None = None,
+ asset_filters: dict[str, Any] | None = None,
+) -> str:
+ """Generate preview renderings of a creative manifest.
+
+ Args:
+ format_id: Format identifier for rendering
+ creative_manifest: Complete creative manifest with all required assets
+ inputs: Array of input sets for generating multiple preview variants
+ template_id: Specific template for custom format rendering
+ brand_card: Brand information manifest providing context for dynamic previews
+ promoted_products: Products/offerings being promoted
+ asset_filters: Filters to select specific assets from brand card (tags, asset_types, exclude_tags)
+
+ Returns:
+ JSON string with preview response containing array of preview variants
+ """
+ try:
+ # Import schema types
+ from .schemas.manifest import CreativeManifest, PreviewInput
+
+ # Parse manifest dict into CreativeManifest
+ manifest_obj = CreativeManifest(**creative_manifest)
+
+ # Parse inputs if provided
+ inputs_obj: list[PreviewInput] | None = None
+ if inputs:
+ inputs_obj = [PreviewInput(**inp) for inp in inputs]
+
+ # Parse request
+ request = PreviewCreativeRequest(
+ format_id=format_id,
+ creative_manifest=manifest_obj,
+ inputs=inputs_obj,
+ template_id=template_id,
+ brand_card=brand_card,
+ promoted_products=promoted_products,
+ asset_filters=asset_filters,
+ )
+
+ # Validate format exists
+ fmt = get_format_by_id(request.format_id)
+ if not fmt:
+ return json.dumps(
+ {"error": f"Format {request.format_id} not found"},
+ indent=2,
+ )
+
+ # Validate manifest format_id matches
+ if request.creative_manifest.format_id != request.format_id:
+ return json.dumps(
+ {
+ "error": f"Manifest format_id '{request.creative_manifest.format_id}' does not match request format_id '{request.format_id}'"
+ },
+ indent=2,
+ )
+
+ # Generate preview variants
+ previews = []
+ preview_id = str(uuid.uuid4())
+
+ # If no inputs provided, generate default variants (desktop, mobile, tablet)
+ if not request.inputs:
+ request.inputs = [
+ PreviewInput(name="Desktop", macros={"DEVICE_TYPE": "desktop"}),
+ PreviewInput(name="Mobile", macros={"DEVICE_TYPE": "mobile"}),
+ PreviewInput(name="Tablet", macros={"DEVICE_TYPE": "tablet"}),
+ ]
+
+ # Generate a preview for each input set
+ from .storage import generate_preview_html, upload_preview_html
+
+ for input_set in request.inputs:
+ # Generate HTML content
+ html_content = generate_preview_html(fmt, request.creative_manifest, input_set)
+
+ # Upload to Tigris and get public URL
+ variant_name = input_set.name.lower().replace(" ", "-")
+ preview_url = upload_preview_html(preview_id, variant_name, html_content)
+
+ # Create preview variant with actual URL
+ preview = _generate_preview_variant(
+ format_obj=fmt,
+ manifest=request.creative_manifest,
+ input_set=input_set,
+ preview_id=preview_id,
+ preview_url=preview_url,
+ )
+ previews.append(preview)
+
+ # Calculate expiration (24 hours from now)
+ expires_at = (datetime.now(UTC) + timedelta(hours=24)).isoformat()
+
+ response = PreviewCreativeResponse(
+ previews=previews,
+ interactive_url=f"{AGENT_URL}/preview/{preview_id}/interactive",
+ expires_at=expires_at,
+ )
+
+ return response.model_dump_json(indent=2)
+ except Exception as e:
+ return json.dumps({"error": str(e)}, indent=2)
+
+
+def _generate_preview_variant(
+ format_obj: Any,
+ manifest: Any,
+ input_set: Any,
+ preview_id: str,
+ preview_url: str,
+) -> PreviewVariant:
+ """Generate a single preview variant - always returns HTML page."""
+ from .schemas.manifest import PreviewEmbedding, PreviewHints
+
+ # Build hints based on format type
+ hints = PreviewHints()
+
+ if format_obj.type == "video":
+ hints.primary_media_type = "video"
+ hints.contains_audio = True
+ if format_obj.requirements and format_obj.requirements.duration_seconds:
+ hints.estimated_duration_seconds = format_obj.requirements.duration_seconds
+ elif format_obj.type == "audio":
+ hints.primary_media_type = "audio"
+ hints.contains_audio = True
+ if format_obj.requirements and format_obj.requirements.duration_seconds:
+ hints.estimated_duration_seconds = format_obj.requirements.duration_seconds
+ elif format_obj.type in ["display", "native", "dooh"]:
+ hints.primary_media_type = "image"
+ hints.contains_audio = False
+ else:
+ hints.requires_interaction = True
+
+ # Extract dimensions if available
+ if format_obj.dimensions:
+ parts = format_obj.dimensions.split("x")
+ if len(parts) == 2:
+ hints.estimated_dimensions = {"width": int(parts[0]), "height": int(parts[1])}
+
+ # Build embedding security metadata
+ embedding = PreviewEmbedding(
+ recommended_sandbox="allow-scripts allow-same-origin",
+ requires_https=False,
+ supports_fullscreen=format_obj.type in ["video", "interactive"],
+ )
+
+ return PreviewVariant(
+ preview_url=preview_url,
+ input=input_set,
+ hints=hints,
+ embedding=embedding,
+ )
+
+
+@mcp.tool()
+def build_creative(
+ message: str,
+ format_id: str,
+ gemini_api_key: str,
+ format_source: str | None = None,
+ context_id: str | None = None,
+ assets: list[dict[str, Any]] | None = None,
+ brand_card: dict[str, Any] | None = None,
+ promoted_offerings: dict[str, Any] | None = None,
+ output_mode: str = "manifest",
+ preview_options: dict[str, Any] | None = None,
+ finalize: bool = False,
+) -> str:
+ """Build a creative manifest using AI generation (requires user's Gemini API key).
+
+ Args:
+ message: Creative brief or refinement instructions
+ format_id: Format identifier to build for (use generative formats like display_300x250_generative)
+ gemini_api_key: User's Gemini API key (REQUIRED - we don't store or pay for API calls)
+ format_source: Optional sales agent URL for custom format lookup
+ context_id: Session ID for iterative refinement
+ assets: Optional asset library references
+ brand_card: (Deprecated) Brand information - use promoted_offerings instead
+ promoted_offerings: Brand and product information for AI generation (replaces brand_card)
+ output_mode: "manifest" for static creative or "code" for dynamic
+ preview_options: Preview generation options
+ finalize: Set to true to finalize the creative
+
+ Returns:
+ JSON string with build response containing creative manifest
+ """
+ try:
+ # Validate API key is provided
+ if not gemini_api_key:
+ return json.dumps(
+ {
+ "error": "gemini_api_key is required. Please provide your own Gemini API key. "
+ "Get one at https://ai.google.dev/"
+ },
+ indent=2,
+ )
+
+ # Import schema types
+ from pydantic import HttpUrl
+
+ from .schemas.build import AssetReference
+ from .schemas.build import PreviewOptions as PreviewOptionsModel
+
+ # Parse assets into AssetReference objects
+ asset_refs: list[AssetReference] = []
+ if assets:
+ asset_refs = [AssetReference(**asset) for asset in assets]
+
+ # Parse format_source into HttpUrl if provided
+ format_source_url: HttpUrl | None = None
+ if format_source:
+ format_source_url = HttpUrl(format_source)
+
+ # Parse preview_options into PreviewOptions object
+ preview_opts: PreviewOptionsModel | None = None
+ if preview_options:
+ preview_opts = PreviewOptionsModel(**preview_options)
+
+ # Validate output_mode
+ if output_mode not in ["manifest", "code"]:
+ return json.dumps(
+ {"error": f"Invalid output_mode '{output_mode}'. Must be 'manifest' or 'code'"},
+ indent=2,
+ )
+
+ # Parse request
+ request = BuildCreativeRequest(
+ message=message,
+ format_id=format_id,
+ format_source=format_source_url,
+ context_id=context_id,
+ assets=asset_refs,
+ output_mode=output_mode, # type: ignore[arg-type]
+ preview_options=preview_opts,
+ finalize=finalize,
+ gemini_api_key=gemini_api_key,
+ )
+
+ # Get format definition
+ fmt = get_format_by_id(request.format_id)
+ if not fmt:
+ return json.dumps(
+ {"error": f"Format {request.format_id} not found"},
+ indent=2,
+ )
+
+ # For generative formats, get the output format for asset requirements
+ output_fmt = fmt
+ if fmt.type == "generative" and fmt.output_format:
+ output_fmt_result = get_format_by_id(fmt.output_format)
+ if not output_fmt_result:
+ return json.dumps(
+ {"error": f"Output format {fmt.output_format} not found"},
+ indent=2,
+ )
+ output_fmt = output_fmt_result
+
+ # Initialize Gemini with user's API key using newer google-genai package
+ from google import genai
+ from google.genai import types
+
+ client = genai.Client(api_key=request.gemini_api_key)
+
+ # Build prompt for creative generation
+ # For generative formats, describe what we're generating (the output format)
+ target_format = output_fmt if fmt.type == "generative" else fmt
+
+ format_spec = f"""Format: {fmt.name}
+Type: {fmt.type}
+Description: {fmt.description}
+"""
+
+ if fmt.type == "generative":
+ format_spec += f"\nThis will generate a: {output_fmt.name}\n"
+ if output_fmt.dimensions:
+ format_spec += f"Dimensions: {output_fmt.dimensions}\n"
+
+ format_spec += "\nRequired Assets:\n"
+
+ for asset_req in target_format.assets_required:
+ format_spec += f"- {asset_req.asset_role} ({asset_req.asset_type})"
+ if asset_req.width and asset_req.height:
+ format_spec += f" - {asset_req.width}x{asset_req.height}"
+ format_spec += f": {asset_req.description or 'N/A'}\n"
+
+ # Add brand context if provided (support both promoted_offerings and deprecated brand_card)
+ brand_data = promoted_offerings or brand_card
+ brand_context = ""
+ if brand_data:
+ brand_context = "\n\nBrand Context:\n"
+
+ # Handle promoted_offerings structure
+ if "offerings" in brand_data:
+ for offering in brand_data["offerings"]:
+ if "name" in offering:
+ brand_context += f"- Product: {offering['name']}\n"
+ if "description" in offering:
+ brand_context += f" Description: {offering['description']}\n"
+ if "assets" in offering:
+ brand_context += f" Assets: {len(offering['assets'])} available\n"
+
+ # Handle brand_card structure (backward compatibility)
+ if "url" in brand_data:
+ brand_context += f"- Brand Website: {brand_data['url']}\n"
+ if "colors" in brand_data:
+ brand_context += f"- Brand Colors: {', '.join(brand_data['colors'])}\n"
+ if "fonts" in brand_data:
+ brand_context += f"- Brand Fonts: {', '.join(brand_data['fonts'])}\n"
+ if "tone" in brand_data:
+ brand_context += f"- Brand Tone: {brand_data['tone']}\n"
+ if "assets" in brand_data and len(brand_data["assets"]) > 0:
+ brand_context += f"- Available Brand Assets: {len(brand_data['assets'])} assets (logos, images, etc.)\n"
+
+ # Check if we need to generate images (check target format, not input generative format)
+ generate_images = target_format.type == "display" and any(
+ req.asset_type == "image" for req in target_format.assets_required
+ )
+
+ # The format_id in the output manifest should be the OUTPUT format
+ output_format_id = output_fmt.format_id if fmt.type == "generative" else request.format_id
+
+ if generate_images:
+ prompt = f"""You are a creative generation AI for advertising.
+
+{format_spec}{brand_context}
+
+User Request: {request.message}
+
+IMPORTANT: Generate actual images for the required image assets. Use the brand assets provided as style references.
+After generating the images, output ONLY a JSON creative manifest with this structure:
+
+{{
+ "format_id": "{output_format_id}",
+ "assets": {{
+ // Map each required asset_role to appropriate asset data
+ // For images: {{"asset_type": "image", "url": "GENERATED_IMAGE_PLACEHOLDER", "width": X, "height": Y, "format": "png"}}
+ // For text: {{"asset_type": "text", "content": "..."}}
+ // For urls: {{"asset_type": "url", "url": "..."}}
+ }},
+ "metadata": {{
+ "generated_by": "AdCP Creative Agent",
+ "timestamp": "{datetime.now(UTC).isoformat()}"
+ }}
+}}
+
+Generate images first, then return the JSON manifest."""
+ else:
+ prompt = f"""You are a creative generation AI for advertising. Generate a creative manifest for the following request:
+
+{format_spec}{brand_context}
+
+User Request: {request.message}
+
+Generate a JSON creative manifest with the following structure:
+{{
+ "format_id": "{output_format_id}",
+ "assets": {{
+ // Map each required asset_role to appropriate asset data
+ // For text: {{"asset_type": "text", "content": "..."}}
+ // For urls: {{"asset_type": "url", "url": "..."}}
+ }},
+ "metadata": {{
+ "generated_by": "AdCP Creative Agent",
+ "timestamp": "{datetime.now(UTC).isoformat()}"
+ }}
+}}
+
+Return ONLY the JSON manifest, no additional text."""
+
+ # Prepare contents array with prompt and optional brand asset images
+ contents: list[Any] = [prompt]
+
+ # Add brand asset images if provided (from promoted_offerings or brand_card)
+ import httpx
+
+ # Collect all image assets from various sources
+ image_assets = []
+
+ if brand_data:
+ # Get images from promoted_offerings offerings
+ if "offerings" in brand_data:
+ for offering in brand_data["offerings"]:
+ if "assets" in offering:
+ image_assets.extend(offering["assets"])
+
+ # Get images from brand_card assets (backward compatibility)
+ if "assets" in brand_data:
+ image_assets.extend(brand_data["assets"])
+
+ # Fetch and add all image assets
+ for asset in image_assets:
+ if isinstance(asset, dict) and asset.get("asset_type") == "image":
+ img_url = asset.get("url")
+ if img_url:
+ try:
+ # Fetch image from URL
+ img_response = httpx.get(img_url, timeout=10.0)
+ img_response.raise_for_status()
+ img_bytes = img_response.content
+
+ # Determine mime type from content-type header or URL
+ mime_type = img_response.headers.get("content-type", "image/png")
+ if not mime_type.startswith("image/"):
+ mime_type = "image/png"
+
+ # Add image as Part
+ contents.append(types.Part.from_bytes(data=img_bytes, mime_type=mime_type))
+ except Exception as e:
+ # Log error but continue with other images
+ print(f"Warning: Failed to fetch brand asset image {img_url}: {e}")
+
+ if generate_images:
+ # Use image generation model
+ response = client.models.generate_content(
+ model="gemini-2.5-flash-image",
+ contents=contents,
+ )
+ else:
+ # Use text-only model
+ response = client.models.generate_content(
+ model="gemini-2.0-flash-exp",
+ contents=contents,
+ )
+
+ generated_text = ""
+ generated_images = []
+
+ if response.candidates and response.candidates[0].content and response.candidates[0].content.parts:
+ for part in response.candidates[0].content.parts:
+ if part.text is not None:
+ generated_text += part.text
+ elif part.inline_data is not None and part.inline_data.data is not None:
+ # Save generated image
+ import base64
+ from io import BytesIO
+
+ from PIL import Image
+
+ image = Image.open(BytesIO(part.inline_data.data))
+ # Convert to base64 data URI
+ buffered = BytesIO()
+ image.save(buffered, format="PNG")
+ img_data = base64.b64encode(buffered.getvalue()).decode()
+ generated_images.append(f"data:image/png;base64,{img_data}")
+
+ # Extract JSON from response (handle markdown code blocks)
+ import re
+
+ json_match = re.search(r"```json\s*(.*?)\s*```", generated_text, re.DOTALL)
+ if json_match:
+ manifest_json = json_match.group(1)
+ else:
+ # Try to find JSON directly
+ manifest_json = generated_text.strip()
+
+ # Parse the generated manifest
+ manifest_data = json.loads(manifest_json)
+
+ # If we generated images, inject them into the manifest
+ if generated_images and "assets" in manifest_data:
+ image_index = 0
+ for _asset_role, asset_data in manifest_data["assets"].items():
+ if isinstance(asset_data, dict) and asset_data.get("asset_type") == "image":
+ if image_index < len(generated_images):
+ # Use generated image as data URI
+ asset_data["url"] = generated_images[image_index]
+ image_index += 1
+
+ # Generate session context ID
+ session_context_id = request.context_id or str(uuid.uuid4())
+
+ # Determine status - must be one of the literal types
+ from typing import Literal
+
+ status: Literal["draft", "ready", "finalized"]
+ if request.finalize:
+ status = "finalized"
+ elif "ready" in request.message.lower():
+ status = "ready"
+ else:
+ status = "draft"
+
+ # Build response
+ build_response = BuildCreativeResponse(
+ message=f"Generated {fmt.name} creative based on your request. {'Finalized and ready to use.' if request.finalize else 'Review and refine as needed.'}",
+ context_id=session_context_id,
+ status=status,
+ creative_output=CreativeOutput(
+ type="creative_manifest",
+ format_id=output_format_id,
+ data=manifest_data,
+ ),
+ preview=None, # Could integrate with preview_creative here
+ refinement_suggestions=[
+ "Consider A/B testing different headlines",
+ "Test various CTA button colors",
+ "Try different image crops for mobile vs desktop",
+ ]
+ if not request.finalize
+ else [],
+ )
+
+ return build_response.model_dump_json(indent=2)
+
+ except json.JSONDecodeError as e:
+ return json.dumps(
+ {"error": f"Failed to parse generated creative: {e!s}"},
+ indent=2,
+ )
+ except Exception as e:
+ return json.dumps(
+ {"error": f"Creative generation failed: {e!s}"},
+ indent=2,
+ )
+
+
+if __name__ == "__main__":
+ # Check if we're in production (Fly.io)
+ if os.getenv("PRODUCTION") == "true":
+ port = int(os.getenv("PORT", "8080"))
+ mcp.run(transport="streamable-http", host="0.0.0.0", port=port)
+ else:
+ # Local development uses stdio
+ mcp.run()
diff --git a/src/creative_agent/storage.py b/src/creative_agent/storage.py
new file mode 100644
index 0000000..9660d1f
--- /dev/null
+++ b/src/creative_agent/storage.py
@@ -0,0 +1,156 @@
+"""Tigris storage for preview HTML and assets."""
+
+import os
+from typing import Any
+
+import boto3
+from botocore.client import Config
+
+# Get Tigris credentials from environment (set by Fly.io)
+AWS_ACCESS_KEY_ID = os.getenv("AWS_ACCESS_KEY_ID")
+AWS_SECRET_ACCESS_KEY = os.getenv("AWS_SECRET_ACCESS_KEY")
+AWS_ENDPOINT_URL = os.getenv("AWS_ENDPOINT_URL_S3")
+AWS_REGION = os.getenv("AWS_REGION", "auto")
+BUCKET_NAME = os.getenv("BUCKET_NAME", "adcp-previews")
+
+
+def get_s3_client() -> Any:
+ """Get configured S3 client for Tigris."""
+ return boto3.client(
+ "s3",
+ aws_access_key_id=AWS_ACCESS_KEY_ID,
+ aws_secret_access_key=AWS_SECRET_ACCESS_KEY,
+ endpoint_url=AWS_ENDPOINT_URL,
+ region_name=AWS_REGION,
+ config=Config(signature_version="s3v4"),
+ )
+
+
+def upload_preview_html(preview_id: str, variant_name: str, html_content: str) -> str:
+ """Upload preview HTML to Tigris and return public URL.
+
+ Args:
+ preview_id: Unique preview session ID
+ variant_name: Name of the variant (e.g., "mobile", "desktop")
+ html_content: HTML content to upload
+
+ Returns:
+ Public URL to the uploaded HTML
+ """
+ s3 = get_s3_client()
+
+ # Create S3 key: previews/{preview_id}/{variant_name}.html
+ key = f"previews/{preview_id}/{variant_name}.html"
+
+ # Upload with correct content type
+ s3.put_object(
+ Bucket=BUCKET_NAME,
+ Key=key,
+ Body=html_content.encode("utf-8"),
+ ContentType="text/html",
+ CacheControl="public, max-age=3600", # Cache for 1 hour
+ )
+
+ # For public buckets, use virtual-hosted-style URL format
+ # Format: https://{bucket}.fly.storage.tigris.dev/{key}
+ return f"https://{BUCKET_NAME}.fly.storage.tigris.dev/{key}"
+
+
+def generate_preview_html(format_obj: Any, manifest: Any, input_set: Any) -> str:
+ """Generate HTML preview content for a creative manifest.
+
+ Args:
+ format_obj: Format definition
+ manifest: Creative manifest
+ input_set: Preview input configuration
+
+ Returns:
+ HTML string ready to display in iframe
+ """
+ # Extract dimensions if available
+ width = 300
+ height = 250
+ if format_obj.dimensions:
+ parts = format_obj.dimensions.split("x")
+ if len(parts) == 2:
+ width = int(parts[0])
+ height = int(parts[1])
+
+ # Get primary image asset
+ image_url = None
+ for _asset_role, asset_data in manifest.assets.items():
+ if isinstance(asset_data, dict) and asset_data.get("asset_type") == "image":
+ image_url = asset_data.get("url")
+ break
+
+ # Get click URL
+ click_url = None
+ for _asset_role, asset_data in manifest.assets.items():
+ if isinstance(asset_data, dict) and asset_data.get("asset_type") == "url":
+ click_url = asset_data.get("url")
+ break
+
+ # Generate simple HTML preview
+ html = f"""
+
+
+
+
+ {format_obj.name} - {input_set.name}
+
+
+
+
+"""
+
+ if image_url:
+ html += f'
\n'
+ else:
+ html += f'
{format_obj.name}
\n'
+
+ html += f"""
{input_set.name}
+