Skip to content

Automate browser based workflows with AI

feat(SKY-12255): persist per-run topup credits consumed on workflow_runs (#7321)

Aaron Perez4a9aaa6df393
diff --git a/alembic/versions/2026_07_12_1933-a0d23605c574_add_topup_credits_used_to_workflow_runs.py b/alembic/versions/2026_07_12_1933-a0d23605c574_add_topup_credits_used_to_workflow_runs.py
new file mode 100644
index 000000000..59824dba1
--- /dev/null
+++ b/alembic/versions/2026_07_12_1933-a0d23605c574_add_topup_credits_used_to_workflow_runs.py
@@ -0,0 +1,33 @@
+"""add_topup_credits_used_to_workflow_runs
+
+Revision ID: a0d23605c574
+Revises: 062b0fc39d36
+Create Date: 2026-07-12T19:33:30.887512+00:00
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "a0d23605c574"
+down_revision: Union[str, None] = "062b0fc39d36"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+_COLUMN_NAME = "topup_credits_used"
+_LOCK_TIMEOUT = "5s"
+
+
+def upgrade() -> None:
+ op.execute(f"SET LOCAL lock_timeout = '{_LOCK_TIMEOUT}'")
+ # Nullable ADD COLUMN with a constant server_default is metadata-only on PG 11+, safe on high-traffic workflow_runs.
+ op.add_column("workflow_runs", sa.Column(_COLUMN_NAME, sa.Integer(), server_default="0", nullable=True))
+
+
+def downgrade() -> None:
+ op.execute(f"SET LOCAL lock_timeout = '{_LOCK_TIMEOUT}'")
+ op.drop_column("workflow_runs", _COLUMN_NAME)
diff --git a/skyvern/forge/sdk/db/models.py b/skyvern/forge/sdk/db/models.py
index 45f62107d..0854a8753 100644
--- a/skyvern/forge/sdk/db/models.py
+++ b/skyvern/forge/sdk/db/models.py
@@ -748,6 +748,7 @@ class WorkflowRunModel(Base):
credits_used = Column(Integer, nullable=True, default=0, server_default="0")
cached_credits_used = Column(Integer, nullable=True, default=0, server_default="0")
+ topup_credits_used = Column(Integer, nullable=True, default=0, server_default="0")
queued_at = Column(DateTime, nullable=True)
started_at = Column(DateTime, nullable=True)
diff --git a/skyvern/forge/sdk/db/repositories/workflow_runs.py b/skyvern/forge/sdk/db/repositories/workflow_runs.py
index f9771aed7..7667ef4aa 100644
--- a/skyvern/forge/sdk/db/repositories/workflow_runs.py
+++ b/skyvern/forge/sdk/db/repositories/workflow_runs.py
@@ -356,13 +356,16 @@ class WorkflowRunsRepository(BaseRepository):
workflow_run_id: str,
credits: int,
is_cached: bool = False,
+ topup_credits: int = 0,
) -> None:
col = WorkflowRunModel.cached_credits_used if is_cached else WorkflowRunModel.credits_used
+ values: dict = {col: func.coalesce(col, 0) + credits}
+ if topup_credits:
+ topup_col = WorkflowRunModel.topup_credits_used
+ values[topup_col] = func.coalesce(topup_col, 0) + topup_credits
async with self.Session() as session:
result = await session.execute(
- update(WorkflowRunModel)
- .where(WorkflowRunModel.workflow_run_id == workflow_run_id)
- .values({col: func.coalesce(col, 0) + credits})
+ update(WorkflowRunModel).where(WorkflowRunModel.workflow_run_id == workflow_run_id).values(values)
)
if result.rowcount == 0:
LOG.warning(