agentgear-ai 0.1.16__py3-none-any.whl

agentgear/server/app/models.py

@@ -0,0 +1,339 @@
+import uuid
+from datetime import datetime
+
+from sqlalchemy import (
+    Boolean,
+    Column,
+    DateTime,
+    Float,
+    ForeignKey,
+    Integer,
+    JSON,
+    String,
+    Text,
+    func,
+)
+from sqlalchemy.orm import relationship
+
+from agentgear.server.app.db import Base
+
+
+def _uuid() -> str:
+    return str(uuid.uuid4())
+
+
+class Project(Base):
+    __tablename__ = "projects"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    name = Column(String, nullable=False, unique=True)
+    description = Column(Text, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    prompts = relationship("Prompt", back_populates="project", cascade="all, delete-orphan")
+    tokens = relationship("APIKey", back_populates="project", cascade="all, delete-orphan")
+    runs = relationship("Run", back_populates="project", cascade="all, delete-orphan")
+    users = relationship("User", back_populates="project")
+    traces = relationship("Trace", back_populates="project", cascade="all, delete-orphan")
+    datasets = relationship("Dataset", back_populates="project", cascade="all, delete-orphan")
+    evaluations = relationship("Evaluation", back_populates="project", cascade="all, delete-orphan")
+    smtp_settings = relationship("SMTPSettings", back_populates="project", cascade="all, delete-orphan", uselist=False)
+    alert_rules = relationship("AlertRule", back_populates="project", cascade="all, delete-orphan")
+    metric_aggregates = relationship("MetricAggregate", back_populates="project", cascade="all, delete-orphan")
+
+
+class APIKey(Base):
+    __tablename__ = "api_keys"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    key_hash = Column(String, nullable=False, unique=True, index=True)
+    scopes = Column(JSON, nullable=False, default=list)
+    role = Column(String, default="user", nullable=False)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+    revoked = Column(Boolean, default=False, nullable=False)
+    last_used_at = Column(DateTime(timezone=True), nullable=True)
+
+    project = relationship("Project", back_populates="tokens")
+
+
+class Prompt(Base):
+    __tablename__ = "prompts"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    name = Column(String, nullable=False)
+    description = Column(Text, nullable=True)
+    scope = Column(String, default="project", nullable=False)  # global vs project
+    tags = Column(JSON, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    project = relationship("Project", back_populates="prompts")
+    versions = relationship("PromptVersion", back_populates="prompt", cascade="all, delete-orphan")
+
+
+class PromptVersion(Base):
+    __tablename__ = "prompt_versions"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    prompt_id = Column(String, ForeignKey("prompts.id"), nullable=False, index=True)
+    version = Column(Integer, nullable=False)
+    content = Column(Text, nullable=False)
+    metadata_ = Column("metadata", JSON, nullable=True)  # "metadata" attribute name is reserved
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    prompt = relationship("Prompt", back_populates="versions")
+
+
+class Trace(Base):
+    __tablename__ = "traces"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    prompt_version_id = Column(String, ForeignKey("prompt_versions.id"), nullable=True, index=True)
+    name = Column(String, nullable=True)
+    status = Column(String, nullable=True)
+    input_text = Column(Text, nullable=True)
+    output_text = Column(Text, nullable=True)
+    model = Column(String, nullable=True)
+    request_payload = Column(JSON, nullable=True)
+    response_payload = Column(JSON, nullable=True)
+    token_input = Column(Integer, nullable=True)
+    token_output = Column(Integer, nullable=True)
+    cost = Column(Float, nullable=True)
+    latency_ms = Column(Float, nullable=True)
+    error = Column(Text, nullable=True)
+    error_stack = Column(Text, nullable=True)
+    tags = Column(JSON, nullable=True)
+    metadata_ = Column("metadata", JSON, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    project = relationship("Project", back_populates="traces")
+    prompt_version = relationship("PromptVersion")
+
+
+class Run(Base):
+    __tablename__ = "runs"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    trace_id = Column(String, ForeignKey("traces.id"), nullable=True, index=True)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    prompt_version_id = Column(String, ForeignKey("prompt_versions.id"), nullable=True, index=True)
+    name = Column(String, nullable=True)
+    status = Column(String, nullable=True)
+    input_text = Column(Text, nullable=True)
+    output_text = Column(Text, nullable=True)
+    model = Column(String, nullable=True)
+    request_payload = Column(JSON, nullable=True)
+    response_payload = Column(JSON, nullable=True)
+    token_input = Column(Integer, nullable=True)
+    token_output = Column(Integer, nullable=True)
+    cost = Column(Float, nullable=True)
+    latency_ms = Column(Float, nullable=True)
+    error = Column(Text, nullable=True)
+    error_stack = Column(Text, nullable=True)
+    tags = Column(JSON, nullable=True)
+    metadata_ = Column("metadata", JSON, nullable=True)  # "metadata" attribute name is reserved
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    trace = relationship("Trace")
+    project = relationship("Project", back_populates="runs")
+    prompt_version = relationship("PromptVersion")
+    spans = relationship("Span", back_populates="run", cascade="all, delete-orphan")
+
+
+class Span(Base):
+    __tablename__ = "spans"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    trace_id = Column(String, ForeignKey("traces.id"), nullable=True, index=True)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    run_id = Column(String, ForeignKey("runs.id"), nullable=False, index=True)
+    parent_id = Column(String, ForeignKey("spans.id"), nullable=True, index=True)
+    name = Column(String, nullable=False)
+    start_time = Column(DateTime(timezone=True), default=datetime.utcnow, nullable=False)
+    end_time = Column(DateTime(timezone=True), nullable=True)
+    latency_ms = Column(Float, nullable=True)
+    status = Column(String, nullable=True)
+    model = Column(String, nullable=True)
+    request_payload = Column(JSON, nullable=True)
+    response_payload = Column(JSON, nullable=True)
+    token_input = Column(Integer, nullable=True)
+    token_output = Column(Integer, nullable=True)
+    cost = Column(Float, nullable=True)
+    error = Column(Text, nullable=True)
+    error_stack = Column(Text, nullable=True)
+    tags = Column(JSON, nullable=True)
+    metadata_ = Column("metadata", JSON, nullable=True)  # "metadata" attribute name is reserved
+
+    trace = relationship("Trace")
+    run = relationship("Run", back_populates="spans")
+    parent = relationship("Span", remote_side=[id])
+
+
+class User(Base):
+    __tablename__ = "users"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=True, index=True)
+    username = Column(String, unique=True, nullable=False, index=True)
+    email = Column(String, unique=True, nullable=True)
+    password_hash = Column(String, nullable=False)
+    salt = Column(String, nullable=False)
+    role = Column(String, default="user", nullable=False)  # admin, user
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+    # can access multiple projects? For now, simplistic single project or global admin
+    
+    project = relationship("Project", back_populates="users")
+
+
+class LLMModel(Base):
+    __tablename__ = "llm_models"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    name = Column(String, nullable=False)
+    provider = Column(String, nullable=False) # openai, anthropic, etc.
+    api_key = Column(String, nullable=True) # encrypted/masked? Storing raw for now for simplicity in this task
+    base_url = Column(String, nullable=True)
+    config = Column(JSON, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+
+class AdminUser(Base):
+    __tablename__ = "admin_users"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    username = Column(String, unique=True, nullable=False, index=True)
+    password_hash = Column(String, nullable=False)
+    salt = Column(String, nullable=False)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+class Evaluation(Base):
+    __tablename__ = "evaluations"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    trace_id = Column(String, ForeignKey("traces.id"), nullable=True, index=True)
+    run_id = Column(String, ForeignKey("runs.id"), nullable=True, index=True)
+    span_id = Column(String, ForeignKey("spans.id"), nullable=True, index=True)
+    evaluator_type = Column(String, nullable=False)  # human, rule, model, etc.
+    score = Column(Float, nullable=True)
+    max_score = Column(Float, nullable=True)
+    passed = Column(Boolean, nullable=True)
+    comments = Column(Text, nullable=True)
+    metadata_ = Column("metadata", JSON, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    project = relationship("Project", back_populates="evaluations")
+    trace = relationship("Trace")
+    run = relationship("Run")
+    span = relationship("Span")
+
+
+class Evaluator(Base):
+    __tablename__ = "evaluators"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    name = Column(String, nullable=False)
+    prompt_template = Column(Text, nullable=False)
+    model = Column(String, nullable=False)
+    config = Column(JSON, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    project = relationship("Project")
+
+
+class Dataset(Base):
+    __tablename__ = "datasets"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    name = Column(String, nullable=False)
+    description = Column(Text, nullable=True)
+    tags = Column(JSON, nullable=True)
+    metadata_ = Column("metadata", JSON, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    project = relationship("Project", back_populates="datasets")
+    examples = relationship("DatasetExample", back_populates="dataset", cascade="all, delete-orphan")
+
+
+class DatasetExample(Base):
+    __tablename__ = "dataset_examples"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    dataset_id = Column(String, ForeignKey("datasets.id"), nullable=False, index=True)
+    input_text = Column(Text, nullable=True)
+    expected_output = Column(Text, nullable=True)
+    metadata_ = Column("metadata", JSON, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    dataset = relationship("Dataset", back_populates="examples")
+
+
+class SMTPSettings(Base):
+    __tablename__ = "smtp_settings"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=True, index=True)
+    host = Column(String, nullable=False)
+    port = Column(Integer, nullable=False)
+    username = Column(String, nullable=True)
+    password = Column(String, nullable=True)
+    encryption = Column(String, nullable=True)  # ssl, tls, starttls
+    sender_email = Column(String, nullable=True)
+    enabled = Column(Boolean, default=True, nullable=False)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+    updated_at = Column(DateTime(timezone=True), server_default=func.now(), onupdate=func.now(), nullable=False)
+
+    project = relationship("Project", back_populates="smtp_settings")
+
+
+class AlertRule(Base):
+    __tablename__ = "alert_rules"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    metric = Column(String, nullable=False)
+    threshold = Column(Float, nullable=False)
+    operator = Column(String, nullable=False, default=">")
+    window_minutes = Column(Integer, nullable=False, default=5)
+    recipients = Column(JSON, nullable=True)
+    enabled = Column(Boolean, default=True, nullable=False)
+    metadata_ = Column("metadata", JSON, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    project = relationship("Project", back_populates="alert_rules")
+
+
+class AlertEvent(Base):
+    __tablename__ = "alert_events"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    rule_id = Column(String, ForeignKey("alert_rules.id"), nullable=False, index=True)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    metric = Column(String, nullable=False)
+    value = Column(Float, nullable=True)
+    threshold = Column(Float, nullable=True)
+    traces = Column(JSON, nullable=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    rule = relationship("AlertRule")
+    project = relationship("Project")
+
+
+class MetricAggregate(Base):
+    __tablename__ = "metric_aggregates"
+
+    id = Column(String, primary_key=True, default=_uuid)
+    project_id = Column(String, ForeignKey("projects.id"), nullable=False, index=True)
+    metric = Column(String, nullable=False)
+    granularity = Column(String, nullable=False)  # e.g., minute, hour, day
+    period_start = Column(DateTime(timezone=True), nullable=False)
+    period_end = Column(DateTime(timezone=True), nullable=False)
+    dimensions = Column(JSON, nullable=True)  # e.g., model, prompt_version, span_type
+    values = Column(JSON, nullable=True)  # e.g., avg, p95, p99, count, sum
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+
+    project = relationship("Project", back_populates="metric_aggregates")

agentgear/server/app/schemas.py

@@ -0,0 +1,343 @@
+from datetime import datetime
+from typing import Any, List, Optional, Literal
+
+from pydantic import BaseModel, Field
+
+# ... (Previous schemas) ...
+
+class ORMModel(BaseModel):
+    class Config:
+        from_attributes = True
+        populate_by_name = True
+
+
+class ProjectCreate(BaseModel):
+    name: str
+    description: Optional[str] = None
+
+
+class ProjectRead(ORMModel):
+    id: str
+    name: str
+    description: Optional[str] = None
+    created_at: datetime
+
+
+class TokenCreate(BaseModel):
+    scopes: List[str] = Field(
+        default_factory=lambda: ["runs.write", "prompts.read", "prompts.write", "tokens.manage", "datasets.read", "datasets.write", "evaluations.read", "evaluations.write"]
+    )
+
+
+class TokenRead(ORMModel):
+    id: str
+    project_id: str
+    scopes: List[str]
+    created_at: datetime
+    revoked: bool
+    last_used_at: Optional[datetime] = None
+
+
+class TokenWithSecret(TokenRead):
+    token: str
+
+
+class PromptCreate(BaseModel):
+    project_id: str
+    name: str
+    description: Optional[str] = None
+    scope: Optional[str] = "project"
+    content: str
+    tags: Optional[List[str]] = None
+    metadata: Optional[dict[str, Any]] = None
+
+
+class PromptUpdate(BaseModel):
+    name: Optional[str] = None
+    description: Optional[str] = None
+    tags: Optional[List[str]] = None
+
+
+class PromptVersionCreate(BaseModel):
+    content: str
+    metadata: Optional[dict[str, Any]] = None
+
+
+class PromptRead(ORMModel):
+    id: str
+    project_id: str
+    name: str
+    description: Optional[str] = None
+    scope: str
+    tags: Optional[List[str]] = None
+    created_at: datetime
+
+
+class PromptVersionRead(ORMModel):
+    id: str
+    prompt_id: str
+    version: int
+    content: str
+    metadata: Optional[dict[str, Any]] = Field(default=None, alias="metadata_")
+    created_at: datetime
+
+
+class TokenUsage(BaseModel):
+    prompt: Optional[int] = None
+    completion: Optional[int] = None
+    total: Optional[int] = None
+
+
+class PromptRunRequest(BaseModel):
+    version_id: Optional[str] = None # if None, latest
+    inputs: dict[str, str] = {}
+    model_config_name: Optional[str] = None # ID or name of LLMModel
+    stream: bool = False
+
+
+class PromptRunResponse(BaseModel):
+    output: str
+    error: Optional[str] = None
+    latency_ms: float
+    token_usage: Optional[TokenUsage] = None
+
+
+
+
+
+class RunCreate(BaseModel):
+    project_id: str
+    prompt_version_id: Optional[str] = None
+    name: Optional[str] = None
+    input_text: Optional[str] = None
+    output_text: Optional[str] = None
+    token_usage: Optional[TokenUsage] = None
+    cost: Optional[float] = None
+    latency_ms: Optional[float] = None
+    error: Optional[str] = None
+    metadata: Optional[dict[str, Any]] = None
+
+
+class RunRead(ORMModel):
+    id: str
+    project_id: str
+    prompt_version_id: Optional[str]
+    name: Optional[str]
+    input_text: Optional[str]
+    output_text: Optional[str]
+    token_input: Optional[int]
+    token_output: Optional[int]
+    cost: Optional[float]
+    latency_ms: Optional[float]
+    error: Optional[str]
+    metadata: Optional[dict[str, Any]] = Field(default=None, alias="metadata_")
+    created_at: datetime
+
+
+class SpanCreate(BaseModel):
+    project_id: str
+    run_id: str
+    parent_id: Optional[str] = None
+    name: str
+    start_time: Optional[datetime] = None
+    end_time: Optional[datetime] = None
+    latency_ms: Optional[float] = None
+    metadata: Optional[dict[str, Any]] = None
+
+
+class SpanRead(ORMModel):
+    id: str
+    project_id: str
+    run_id: str
+    parent_id: Optional[str]
+    name: str
+    start_time: datetime
+    end_time: Optional[datetime]
+    latency_ms: Optional[float]
+    metadata: Optional[dict[str, Any]] = Field(default=None, alias="metadata_")
+
+
+class MetricsSummary(BaseModel):
+    runs: int
+    spans: int
+    prompts: int
+    projects: int
+
+
+class AuthStatus(BaseModel):
+    configured: bool
+    mode: Literal["none", "env", "db"]
+    username: Optional[str] = None
+    project_id: Optional[str] = None
+
+
+class AuthSetup(BaseModel):
+    username: str
+    password: str
+
+
+class AuthLogin(BaseModel):
+    username: str
+    password: str
+
+
+class AuthResponse(BaseModel):
+    token: str
+    project_id: str
+    username: str
+    role: str = "user"
+
+
+class UserCreate(BaseModel):
+    username: str
+    password: str
+    email: Optional[str] = None
+    project_id: Optional[str] = None
+    role: str = "user"
+
+
+class UserRead(ORMModel):
+    id: str
+    username: str
+    email: Optional[str]
+    project_id: Optional[str]
+    role: str
+    created_at: datetime
+
+
+class UserPasswordReset(BaseModel):
+    password: str
+
+
+class LLMModelCreate(BaseModel):
+    name: str
+    provider: str
+    api_key: Optional[str] = None
+    base_url: Optional[str] = None
+    config: Optional[dict[str, Any]] = None
+
+
+class LLMModelRead(ORMModel):
+    id: str
+    name: str
+    provider: str
+    base_url: Optional[str]
+    config: Optional[dict[str, Any]]
+    created_at: datetime
+
+# --- NEW SCHEMAS FOR SETTINGS ---
+
+class AlertRuleCreate(BaseModel):
+    project_id: str
+    metric: str
+    threshold: float
+    operator: str = ">"
+    window_minutes: int = 5
+    recipients: List[str]  # List of emails
+    enabled: bool = True
+
+class AlertRuleRead(ORMModel):
+    id: str
+    project_id: str
+    metric: str
+    threshold: float
+    operator: str
+    window_minutes: int
+    recipients: Optional[List[str]]
+    enabled: bool
+    created_at: datetime
+
+class SMTPConfig(BaseModel):
+    host: str
+    port: int
+    username: Optional[str] = None
+    password: Optional[str] = None
+    encryption: Optional[str] = None
+    sender_email: Optional[str] = None
+    enabled: bool = True
+
+class RoleCreate(BaseModel):
+    name: str
+    permissions: List[str]
+
+class RoleRead(BaseModel):
+    id: str
+    name: str
+    permissions: List[str]
+
+
+# --- NEW SCHEMAS FOR DATASETS & EVALUATIONS ---
+
+class DatasetCreate(BaseModel):
+    project_id: Optional[str] = None
+    name: str
+    description: Optional[str] = None
+    tags: Optional[List[str]] = None
+    metadata: Optional[dict[str, Any]] = None
+
+class DatasetRead(ORMModel):
+    id: str
+    project_id: str
+    name: str
+    description: Optional[str] = None
+    tags: Optional[List[str]] = None
+    metadata: Optional[dict[str, Any]] = Field(default=None, alias="metadata_")
+    created_at: datetime
+
+class DatasetExampleCreate(BaseModel):
+    input_text: Optional[str] = None
+    expected_output: Optional[str] = None
+    metadata: Optional[dict[str, Any]] = None
+
+class DatasetExampleRead(ORMModel):
+    id: str
+    dataset_id: str
+    input_text: Optional[str] = None
+    expected_output: Optional[str] = None
+    metadata: Optional[dict[str, Any]] = Field(default=None, alias="metadata_")
+    created_at: datetime
+
+class EvaluationCreate(BaseModel):
+    project_id: str
+    trace_id: Optional[str] = None
+    run_id: Optional[str] = None
+    span_id: Optional[str] = None
+    evaluator_type: str = "manual"
+    score: Optional[float] = None
+    max_score: Optional[float] = None
+    passed: Optional[bool] = None
+    comments: Optional[str] = None
+    metadata: Optional[dict[str, Any]] = None
+
+class EvaluationRead(ORMModel):
+    id: str
+    project_id: str
+    trace_id: Optional[str]
+    run_id: Optional[str]
+    span_id: Optional[str]
+    evaluator_type: str
+    score: Optional[float]
+    max_score: Optional[float]
+    passed: Optional[bool]
+    comments: Optional[str]
+    metadata: Optional[dict[str, Any]] = Field(default=None, alias="metadata_")
+    metadata: Optional[dict[str, Any]] = Field(default=None, alias="metadata_")
+    created_at: datetime
+
+
+class EvaluatorCreate(BaseModel):
+    project_id: Optional[str] = None
+    name: str
+    prompt_template: str
+    model: str
+    config: Optional[dict[str, Any]] = None
+
+class EvaluatorRead(ORMModel):
+    id: str
+    project_id: str
+    name: str
+    prompt_template: str
+    model: str
+    config: Optional[dict[str, Any]]
+    created_at: datetime
+

agentgear/server/app/utils/email.py

@@ -0,0 +1,30 @@
+import smtplib
+from email.mime.text import MIMEText
+from email.mime.multipart import MIMEMultipart
+from typing import List, Optional
+
+from agentgear.server.app.models import SMTPSettings
+
+def send_email(smtp_config: SMTPSettings, recipients: List[str], subject: str, html_content: str):
+    if not smtp_config or not smtp_config.enabled:
+        raise ValueError("SMTP is not configured or enabled")
+
+    msg = MIMEMultipart()
+    msg["From"] = smtp_config.sender_email
+    msg["Subject"] = subject
+    msg.attach(MIMEText(html_content, "html"))
+
+    try:
+        server = smtplib.SMTP(smtp_config.host, smtp_config.port)
+        if smtp_config.encryption == "starttls":
+            server.starttls()
+        elif smtp_config.encryption == "ssl":
+            server = smtplib.SMTP_SSL(smtp_config.host, smtp_config.port)
+        
+        if smtp_config.username and smtp_config.password:
+            server.login(smtp_config.username, smtp_config.password)
+        
+        server.sendmail(smtp_config.sender_email, recipients, msg.as_string())
+        server.quit()
+    except Exception as e:
+        raise Exception(f"Failed to send email: {str(e)}")