""" @model SimulationJob (swarm/models/simulation_job.py) @purpose Persistent state machine model for Swarm Intelligence & Predictive Digital Twin jobs. """ from datetime import datetime import ulid from sqlalchemy import Column, String, Integer, Text, DateTime, JSON, Numeric, Boolean from sqlalchemy.sql import func from app.models.db_base import Base class SimulationJob(Base): __tablename__ = "simulation_jobs" id = Column(String(36), primary_key=True, index=True, default=lambda: str(ulid.ULID())) store_id = Column(Integer, nullable=False, default=1, index=True) user_id = Column(Integer, nullable=False) scenario_type = Column(String(64), nullable=False) status = Column( String(32), nullable=False, default="QUEUED", index=True ) worker_id = Column(String(64), nullable=True) retry_count = Column(Integer, nullable=False, default=0) max_retries = Column(Integer, nullable=False, default=2) cancellation_requested = Column(Boolean, nullable=False, default=False) input_params = Column(JSON, nullable=False) historical_baseline = Column(JSON, nullable=True) simulation_dispersion = Column(JSON, nullable=True) calibrated_projection = Column(JSON, nullable=True) summary_metrics = Column(JSON, nullable=True) report_markdown = Column(Text, nullable=True) agent_logs = Column(JSON, nullable=True) error_message = Column(Text, nullable=True) execution_time_ms = Column(Integer, nullable=True) prompt_tokens = Column(Integer, nullable=True) completion_tokens = Column(Integer, nullable=True) total_cost_usd = Column(Numeric(10, 6), nullable=True) last_heartbeat_at = Column(DateTime, nullable=True, index=True) created_at = Column(DateTime, nullable=False, server_default=func.now(), index=True) started_at = Column(DateTime, nullable=True) completed_at = Column(DateTime, nullable=True)