Files
ss-tools/backend/alembic/versions/g1h2i3j4k5l6_add_agent_runs.py

117 lines
5.5 KiB
Python

# #region Alembic.AddAgentRuns [C:3] [TYPE Module] [SEMANTICS alembic,agent-run,durable]
# @ingroup Alembic
# @BRIEF Add agent_runs, agent_run_events, draft_artifacts, approval_gates tables.
# @LAYER Database
# @RELATION DEPENDS_ON -> [Models.AgentRun]
# @INVARIANT agent_run_events has unique (run_id, sequence); drafts use opaque content_ref.
# @RATIONALE Durable run state is the backend-of-record for scenario runs — survives Gradio restarts.
"""add agent runs tables
Revision ID: g1h2i3j4k5l6
Revises: 8e9f0a1b2c3d
Create Date: 2026-07-28 12:00:00.000000
"""
from typing import Sequence, Union
from alembic import op
import sqlalchemy as sa
# revision identifiers, used by Alembic.
revision: str = "g1h2i3j4k5l6"
down_revision: Union[str, Sequence[str], None] = "8e9f0a1b2c3d"
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None
def upgrade() -> None:
op.create_table(
"agent_runs",
sa.Column("id", sa.String(), nullable=False),
sa.Column("conversation_id", sa.String(128), nullable=True),
sa.Column("user_id", sa.String(), nullable=False),
sa.Column("intent", sa.String(64), nullable=False, server_default="dashboard_scenario_build"),
sa.Column("trigger", sa.String(64), nullable=False, server_default="manual"),
sa.Column("dashboard_id", sa.String(64), nullable=False),
sa.Column("environment_id", sa.String(128), nullable=False),
sa.Column("context_snapshot", sa.JSON(), nullable=False),
sa.Column("status", sa.String(32), nullable=False, server_default="CREATED"),
sa.Column("current_stage", sa.String(32), nullable=True),
sa.Column("last_sequence", sa.Integer(), nullable=False, server_default="0"),
sa.Column("error_code", sa.String(64), nullable=True),
sa.Column("error_detail", sa.Text(), nullable=True),
sa.Column("created_at", sa.DateTime(), nullable=False),
sa.Column("updated_at", sa.DateTime(), nullable=False),
sa.Column("finished_at", sa.DateTime(), nullable=True),
sa.PrimaryKeyConstraint("id"),
)
op.create_index("ix_agent_runs_user_status", "agent_runs", ["user_id", "status"])
op.create_index("ix_agent_runs_dashboard", "agent_runs", ["dashboard_id", "environment_id"])
op.create_table(
"agent_run_events",
sa.Column("id", sa.String(), nullable=False),
sa.Column("run_id", sa.String(), nullable=False),
sa.Column("sequence", sa.Integer(), nullable=False),
sa.Column("event_type", sa.String(32), nullable=False),
sa.Column("stage", sa.String(32), nullable=True),
sa.Column("status", sa.String(32), nullable=True),
sa.Column("payload", sa.JSON(), nullable=True),
sa.Column("payload_hash", sa.String(64), nullable=True),
sa.Column("occurred_at", sa.DateTime(), nullable=False),
sa.ForeignKeyConstraint(["run_id"], ["agent_runs.id"], ondelete="CASCADE"),
sa.PrimaryKeyConstraint("id"),
)
op.create_index("ix_agent_run_events_run_seq", "agent_run_events", ["run_id", "sequence"], unique=True)
op.create_table(
"draft_artifacts",
sa.Column("id", sa.String(), nullable=False),
sa.Column("run_id", sa.String(), nullable=False),
sa.Column("kind", sa.String(32), nullable=False),
sa.Column("name", sa.String(255), nullable=False),
sa.Column("intended_path", sa.String(512), nullable=False),
sa.Column("content_ref", sa.String(256), nullable=False),
sa.Column("sha256", sa.String(64), nullable=False),
sa.Column("validation_status", sa.String(16), nullable=False, server_default="pending"),
sa.Column("warnings", sa.JSON(), nullable=True),
sa.Column("persisted_at", sa.DateTime(), nullable=True),
sa.Column("capture_meta", sa.JSON(), nullable=True),
sa.Column("created_at", sa.DateTime(), nullable=False),
sa.ForeignKeyConstraint(["run_id"], ["agent_runs.id"], ondelete="CASCADE"),
sa.PrimaryKeyConstraint("id"),
)
op.create_index("ix_draft_artifacts_run", "draft_artifacts", ["run_id"])
op.create_table(
"approval_gates",
sa.Column("id", sa.String(), nullable=False),
sa.Column("run_id", sa.String(), nullable=False),
sa.Column("operation", sa.String(32), nullable=False),
sa.Column("request_hash", sa.String(64), nullable=False),
sa.Column("target_paths", sa.JSON(), nullable=False),
sa.Column("risk_level", sa.String(16), nullable=False, server_default="guarded"),
sa.Column("required_permission", sa.String(64), nullable=False),
sa.Column("status", sa.String(16), nullable=False, server_default="pending"),
sa.Column("reason_required", sa.Boolean(), nullable=False, server_default="false"),
sa.Column("reason", sa.Text(), nullable=True),
sa.Column("actor_id", sa.String(), nullable=True),
sa.Column("decided_at", sa.DateTime(), nullable=True),
sa.Column("expires_at", sa.DateTime(), nullable=False),
sa.Column("created_at", sa.DateTime(), nullable=False),
sa.ForeignKeyConstraint(["run_id"], ["agent_runs.id"], ondelete="CASCADE"),
sa.PrimaryKeyConstraint("id"),
)
op.create_index("ix_approval_gates_run", "approval_gates", ["run_id"])
op.create_index("ix_approval_gates_status", "approval_gates", ["status"])
def downgrade() -> None:
op.drop_table("approval_gates")
op.drop_table("draft_artifacts")
op.drop_table("agent_run_events")
op.drop_table("agent_runs")
# #endregion Alembic.AddAgentRuns