runtm-api 0.1.0__tar.gz

runtm_api-0.1.0/.gitignore

@@ -0,0 +1,84 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+/build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.env.local
+.env.*
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+*.swp
+*.swo
+*~
+.cursor/
+.cursor/rules/
+
+# macOS
+.DS_Store
+
+# Project specific
+/artifacts/
+*.log
+
+# Internal planning docs
+.plans/
+
+# Alembic
+packages/api/alembic/versions/*.pyc
+

runtm_api-0.1.0/LICENSE

@@ -0,0 +1,37 @@
+# AGPL-3.0-or-later
+
+Copyright (c) 2025 Runtm
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+---
+
+## Full License Text
+
+The full text of the GNU Affero General Public License v3.0 is available at:
+https://www.gnu.org/licenses/agpl-3.0.txt
+
+### Summary
+
+The AGPL-3.0 license requires that:
+
+1. **Source Code Access**: If you run a modified version of this software as a network service, you must make the complete source code available to users of that service.
+
+2. **Copyleft**: Any modifications must also be licensed under AGPL-3.0.
+
+3. **Attribution**: You must retain copyright notices and license information.
+
+4. **State Changes**: You must document any changes made to the source code.
+
+This license ensures that improvements to hosted versions of Runtm remain open source and benefit the community.

runtm_api-0.1.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: runtm-api
+Version: 0.1.0
+Summary: FastAPI control plane for Runtm
+Project-URL: Homepage, https://runtm.com
+Project-URL: Documentation, https://docs.runtm.com
+Project-URL: Repository, https://github.com/runtm-ai/runtm
+Project-URL: Issues, https://github.com/runtm-ai/runtm/issues
+Author-email: Gustavo Trigos <gus@runtm.com>
+Maintainer-email: Gustavo Trigos <gus@runtm.com>
+License: AGPL-3.0-or-later
+License-File: LICENSE
+Keywords: api,control-plane,deployment,fastapi
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: >=3.9
+Requires-Dist: alembic<2.0,>=1.10
+Requires-Dist: asyncpg<1.0,>=0.27
+Requires-Dist: fastapi<1.0,>=0.100.0
+Requires-Dist: psycopg2-binary<3.0,>=2.9
+Requires-Dist: pydantic-settings<3.0,>=2.0
+Requires-Dist: python-multipart<1.0,>=0.0.6
+Requires-Dist: redis<6.0,>=4.5
+Requires-Dist: rq<3.0,>=2.3.2
+Requires-Dist: runtm-shared>=0.1.0
+Requires-Dist: sqlalchemy<3.0,>=2.0
+Requires-Dist: uvicorn[standard]<1.0,>=0.20.0
+Provides-Extra: dev
+Requires-Dist: httpx<1.0,>=0.24; extra == 'dev'
+Requires-Dist: mypy<2.0,>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio<1.0,>=0.21; extra == 'dev'
+Requires-Dist: pytest-cov<6.0,>=4.0; extra == 'dev'
+Requires-Dist: pytest<9.0,>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# runtm-api
+
+FastAPI control plane for Runtm. See the [API docs](https://docs.runtm.com/api/overview) for endpoint reference.
+
+**Hosted API:** [app.runtm.com](https://app.runtm.com)
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| POST | `/v0/deployments` | Create deployment (multipart: manifest + artifact.zip) |
+| GET | `/v0/deployments/:id` | Get deployment status, URL, timestamps, error |
+| GET | `/v0/deployments/:id/logs` | Get build/deploy logs |
+
+### Creating Deployments
+
+**POST `/v0/deployments`**
+
+Creates a new deployment or redeploys an existing one (based on manifest name).
+
+**Query Parameters:**
+- `new=true` - Force creation of new deployment instead of redeploying existing
+- `tier=starter|standard|performance` - Override machine tier from manifest
+
+**Request:**
+- `manifest` (file) - `runtm.yaml` manifest file
+- `artifact` (file) - `artifact.zip` containing project files
+
+**Headers:**
+- `Authorization: Bearer <token>` - API authentication token
+- `Idempotency-Key: <key>` - Optional idempotency key for retries
+
+**Example:**
+```bash
+curl -X POST "http://localhost:8000/v0/deployments?tier=performance" \
+  -H "Authorization: Bearer $RUNTM_API_KEY" \
+  -F "manifest=@runtm.yaml" \
+  -F "artifact=@artifact.zip"
+```
+
+**Machine Tiers:**
+
+All deployments use **auto-stop** for cost savings (machines stop when idle and start automatically on traffic).
+
+| Tier | CPUs | Memory | Est. Cost |
+|------|------|--------|-----------|
+| `starter` (default) | 1 shared | 256MB | ~$2/month* |
+| `standard` | 1 shared | 512MB | ~$5/month* |
+| `performance` | 2 shared | 1GB | ~$10/month* |
+
+*Costs are estimates for 24/7 operation. With auto-stop, costs are much lower for low-traffic services.
+
+## Development
+
+```bash
+# Install dependencies
+pip install -e ".[dev]"
+
+# Run migrations
+alembic upgrade head
+
+# Start server
+uvicorn runtm_api.main:app --reload --host 0.0.0.0 --port 8000
+
+# Run tests
+pytest
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DATABASE_URL` | PostgreSQL connection string | Required |
+| `REDIS_URL` | Redis connection string | Required |
+| `RUNTM_API_SECRET` | API authentication secret (what server validates against) | Required |
+| `ARTIFACT_STORAGE_PATH` | Local artifact storage path | `/artifacts` |
+| `ARTIFACT_STORAGE_BACKEND` | Storage backend: `local` or `s3` | `local` |
+| `BUCKET_NAME` | S3/Tigris bucket name (when backend=s3) | - |
+| `AWS_ENDPOINT_URL_S3` | S3 endpoint URL (e.g. `https://fly.storage.tigris.dev`) | - |
+| `AUTH_MODE` | Auth mode: `single_tenant` or `multi_tenant` | `single_tenant` |
+

runtm_api-0.1.0/README.md

@@ -0,0 +1,81 @@
+# runtm-api
+
+FastAPI control plane for Runtm. See the [API docs](https://docs.runtm.com/api/overview) for endpoint reference.
+
+**Hosted API:** [app.runtm.com](https://app.runtm.com)
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| POST | `/v0/deployments` | Create deployment (multipart: manifest + artifact.zip) |
+| GET | `/v0/deployments/:id` | Get deployment status, URL, timestamps, error |
+| GET | `/v0/deployments/:id/logs` | Get build/deploy logs |
+
+### Creating Deployments
+
+**POST `/v0/deployments`**
+
+Creates a new deployment or redeploys an existing one (based on manifest name).
+
+**Query Parameters:**
+- `new=true` - Force creation of new deployment instead of redeploying existing
+- `tier=starter|standard|performance` - Override machine tier from manifest
+
+**Request:**
+- `manifest` (file) - `runtm.yaml` manifest file
+- `artifact` (file) - `artifact.zip` containing project files
+
+**Headers:**
+- `Authorization: Bearer <token>` - API authentication token
+- `Idempotency-Key: <key>` - Optional idempotency key for retries
+
+**Example:**
+```bash
+curl -X POST "http://localhost:8000/v0/deployments?tier=performance" \
+  -H "Authorization: Bearer $RUNTM_API_KEY" \
+  -F "manifest=@runtm.yaml" \
+  -F "artifact=@artifact.zip"
+```
+
+**Machine Tiers:**
+
+All deployments use **auto-stop** for cost savings (machines stop when idle and start automatically on traffic).
+
+| Tier | CPUs | Memory | Est. Cost |
+|------|------|--------|-----------|
+| `starter` (default) | 1 shared | 256MB | ~$2/month* |
+| `standard` | 1 shared | 512MB | ~$5/month* |
+| `performance` | 2 shared | 1GB | ~$10/month* |
+
+*Costs are estimates for 24/7 operation. With auto-stop, costs are much lower for low-traffic services.
+
+## Development
+
+```bash
+# Install dependencies
+pip install -e ".[dev]"
+
+# Run migrations
+alembic upgrade head
+
+# Start server
+uvicorn runtm_api.main:app --reload --host 0.0.0.0 --port 8000
+
+# Run tests
+pytest
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DATABASE_URL` | PostgreSQL connection string | Required |
+| `REDIS_URL` | Redis connection string | Required |
+| `RUNTM_API_SECRET` | API authentication secret (what server validates against) | Required |
+| `ARTIFACT_STORAGE_PATH` | Local artifact storage path | `/artifacts` |
+| `ARTIFACT_STORAGE_BACKEND` | Storage backend: `local` or `s3` | `local` |
+| `BUCKET_NAME` | S3/Tigris bucket name (when backend=s3) | - |
+| `AWS_ENDPOINT_URL_S3` | S3 endpoint URL (e.g. `https://fly.storage.tigris.dev`) | - |
+| `AUTH_MODE` | Auth mode: `single_tenant` or `multi_tenant` | `single_tenant` |
+

runtm_api-0.1.0/alembic/env.py

@@ -0,0 +1,86 @@
+"""Alembic environment configuration."""
+
+from __future__ import annotations
+
+import os
+from logging.config import fileConfig
+
+from sqlalchemy import engine_from_config, pool
+
+from alembic import context
+
+# Import Base and all models for autogenerate support
+from runtm_api.db.models import Base
+
+# this is the Alembic Config object, which provides
+# access to the values within the .ini file in use.
+config = context.config
+
+# Interpret the config file for Python logging.
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+# Model metadata for 'autogenerate' support
+target_metadata = Base.metadata
+
+
+def get_url() -> str:
+    """Get database URL from environment or config."""
+    return os.environ.get(
+        "DATABASE_URL",
+        config.get_main_option("sqlalchemy.url", ""),
+    )
+
+
+def run_migrations_offline() -> None:
+    """Run migrations in 'offline' mode.
+
+    This configures the context with just a URL
+    and not an Engine, though an Engine is acceptable
+    here as well.  By skipping the Engine creation
+    we don't even need a DBAPI to be available.
+
+    Calls to context.execute() here emit the given string to the
+    script output.
+    """
+    url = get_url()
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    """Run migrations in 'online' mode.
+
+    In this scenario we need to create an Engine
+    and associate a connection with the context.
+    """
+    configuration = config.get_section(config.config_ini_section) or {}
+    configuration["sqlalchemy.url"] = get_url()
+
+    connectable = engine_from_config(
+        configuration,
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+
+    with connectable.connect() as connection:
+        context.configure(
+            connection=connection,
+            target_metadata=target_metadata,
+        )
+
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

runtm_api-0.1.0/alembic/script.py.mako

@@ -0,0 +1,28 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+"""
+from __future__ import annotations
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}
+

runtm_api-0.1.0/alembic/versions/20251215_0001_initial_schema.py

@@ -0,0 +1,176 @@
+"""Initial schema: deployments, provider_resources, idempotency_keys, build_logs
+
+Revision ID: 0001
+Revises:
+Create Date: 2025-12-15
+
+Full database schema for Runtm including:
+- deployments: Core deployment records with version tracking for redeployments
+- provider_resources: Fly.io/Cloud Run resource mappings
+- idempotency_keys: Safe retry support
+- build_logs: Build and deploy log storage
+"""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from sqlalchemy.dialects import postgresql
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "0001"
+down_revision: str | None = None
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # =========================================================================
+    # Deployments table
+    # =========================================================================
+    # Core deployment records. Each deployment represents a single version
+    # of a project deployed to a URL. Redeployments create new records
+    # linked via previous_deployment_id.
+    op.create_table(
+        "deployments",
+        # Primary key (internal UUID)
+        sa.Column("id", postgresql.UUID(as_uuid=True), primary_key=True),
+        # Human-friendly deployment ID (e.g., dep_abc123def456)
+        sa.Column("deployment_id", sa.String(32), unique=True, nullable=False),
+        # Multi-tenant fields (nullable for single-tenant mode)
+        sa.Column("owner_id", sa.String(64), nullable=True),
+        sa.Column("api_key_id", sa.String(64), nullable=True),
+        # Deployment metadata
+        sa.Column("name", sa.String(63), nullable=False),
+        sa.Column("state", sa.String(32), nullable=False, default="queued"),
+        sa.Column("artifact_key", sa.String(256), nullable=False),
+        sa.Column("manifest_json", postgresql.JSONB, nullable=False),
+        sa.Column("error_message", sa.Text, nullable=True),
+        sa.Column("url", sa.String(256), nullable=True),
+        # Version tracking for redeployments (CI/CD support)
+        # - version: increments on each redeploy (1, 2, 3, ...)
+        # - is_latest: only one deployment per name should be true
+        # - previous_deployment_id: links to the deployment this replaced
+        sa.Column("version", sa.Integer(), nullable=False, server_default="1"),
+        sa.Column("is_latest", sa.Boolean(), nullable=False, server_default="true"),
+        sa.Column("previous_deployment_id", sa.String(32), nullable=True),
+        # Timestamps
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.func.now(),
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.func.now(),
+        ),
+    )
+    op.create_index("ix_deployments_deployment_id", "deployments", ["deployment_id"])
+    op.create_index("ix_deployments_owner_id", "deployments", ["owner_id"])
+    op.create_index("ix_deployments_state", "deployments", ["state"])
+    op.create_index("ix_deployments_created_at", "deployments", ["created_at"])
+    op.create_index("ix_deployments_name", "deployments", ["name"])
+    op.create_index("ix_deployments_name_is_latest", "deployments", ["name", "is_latest"])
+
+    # Partial unique index: only one is_latest=true per (owner_id, name)
+    # This ensures at most one active deployment per name per owner
+    # Excludes destroyed/failed deployments from the constraint
+    # Note: SQLAlchemy with native_enum=False stores enum names (uppercase), not values
+    op.execute("""
+        CREATE UNIQUE INDEX ix_deployments_unique_active_name
+        ON deployments (COALESCE(owner_id, ''), name)
+        WHERE is_latest = true AND state NOT IN ('DESTROYED', 'FAILED')
+    """)
+
+    # =========================================================================
+    # Provider resources table
+    # =========================================================================
+    # Maps deployments to provider-specific resources (Fly.io machines, etc.)
+    op.create_table(
+        "provider_resources",
+        sa.Column("id", postgresql.UUID(as_uuid=True), primary_key=True),
+        sa.Column(
+            "deployment_id",
+            postgresql.UUID(as_uuid=True),
+            sa.ForeignKey("deployments.id", ondelete="CASCADE"),
+            nullable=False,
+            unique=True,
+        ),
+        sa.Column("provider", sa.String(32), nullable=False),
+        sa.Column("app_name", sa.String(128), nullable=False),
+        sa.Column("machine_id", sa.String(128), nullable=False),
+        sa.Column("region", sa.String(32), nullable=False),
+        sa.Column("image_ref", sa.String(256), nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.func.now(),
+        ),
+    )
+    op.create_index("ix_provider_resources_app_name", "provider_resources", ["app_name"])
+    op.create_index("ix_provider_resources_provider", "provider_resources", ["provider"])
+
+    # =========================================================================
+    # Idempotency keys table
+    # =========================================================================
+    # Maps Idempotency-Key headers to deployments for safe retries
+    op.create_table(
+        "idempotency_keys",
+        sa.Column("id", postgresql.UUID(as_uuid=True), primary_key=True),
+        sa.Column("key", sa.String(64), unique=True, nullable=False),
+        sa.Column(
+            "deployment_id",
+            postgresql.UUID(as_uuid=True),
+            sa.ForeignKey("deployments.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.func.now(),
+        ),
+        sa.Column("expires_at", sa.DateTime(timezone=True), nullable=False),
+    )
+    op.create_index("ix_idempotency_keys_key", "idempotency_keys", ["key"])
+    op.create_index("ix_idempotency_keys_expires_at", "idempotency_keys", ["expires_at"])
+
+    # =========================================================================
+    # Build logs table
+    # =========================================================================
+    # Stores build and deploy logs for each deployment
+    op.create_table(
+        "build_logs",
+        sa.Column("id", postgresql.UUID(as_uuid=True), primary_key=True),
+        sa.Column(
+            "deployment_id",
+            postgresql.UUID(as_uuid=True),
+            sa.ForeignKey("deployments.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("log_type", sa.String(32), nullable=False),
+        sa.Column("content", sa.Text, nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.func.now(),
+        ),
+    )
+    op.create_index("ix_build_logs_deployment_id", "build_logs", ["deployment_id"])
+    op.create_index("ix_build_logs_log_type", "build_logs", ["log_type"])
+
+
+def downgrade() -> None:
+    op.execute("DROP INDEX IF EXISTS ix_deployments_unique_active_name")
+    op.drop_table("build_logs")
+    op.drop_table("idempotency_keys")
+    op.drop_table("provider_resources")
+    op.drop_table("deployments")