From 1559160aef619f295f1a9bec68df64a31692606b Mon Sep 17 00:00:00 2001
From: Marc Kelechava <marc@skyvern.com>
Date: Tue, 18 Nov 2025 19:37:56 -0800
Subject: [PATCH] Bill 2.5 cents (50%) for cached steps (#4030)

---
 skyvern/forge/agent_functions.py   |  3 +++
 skyvern/services/script_service.py | 27 ++++++++++++++++++++++++++-
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/skyvern/forge/agent_functions.py b/skyvern/forge/agent_functions.py
index 3579f18b..64bab4f7 100644
--- a/skyvern/forge/agent_functions.py
+++ b/skyvern/forge/agent_functions.py
@@ -495,6 +495,9 @@ class AgentFunction:
     async def post_step_execution(self, task: Task, step: Step) -> None:
         return
 
+    async def post_cache_step_execution(self, task: Task, step: Step) -> None:
+        return
+
     async def generate_async_operations(
         self,
         organization: Organization,
diff --git a/skyvern/services/script_service.py b/skyvern/services/script_service.py
index 334a4b35..2541b17c 100644
--- a/skyvern/services/script_service.py
+++ b/skyvern/services/script_service.py
@@ -18,7 +18,7 @@ from skyvern.constants import GET_DOWNLOADED_FILES_TIMEOUT
 from skyvern.core.script_generations.constants import SCRIPT_TASK_BLOCKS
 from skyvern.core.script_generations.generate_script import _build_block_fn, create_or_update_script_block
 from skyvern.core.script_generations.script_skyvern_page import script_run_context_manager
-from skyvern.exceptions import ScriptNotFound, ScriptTerminationException, WorkflowRunNotFound
+from skyvern.exceptions import ScriptNotFound, ScriptTerminationException, StepTerminationError, WorkflowRunNotFound
 from skyvern.forge import app
 from skyvern.forge.sdk.artifact.models import ArtifactType
 from skyvern.forge.sdk.core import skyvern_context
@@ -612,6 +612,30 @@ async def _update_workflow_block(
 
             task_output = TaskOutput.from_task(updated_task, downloaded_files)
             final_output = task_output.model_dump()
+            step_for_billing: Step | None = None
+            if step_id:
+                step_for_billing = await app.DATABASE.get_step(
+                    step_id=step_id,
+                    organization_id=context.organization_id,
+                )
+            if step_for_billing:
+                try:
+                    if not ai_fallback_triggered:
+                        await app.AGENT_FUNCTION.post_cache_step_execution(
+                            updated_task,
+                            step_for_billing,
+                        )
+                except StepTerminationError as billing_error:
+                    LOG.warning(
+                        "Cached step billing failed; marking workflow block as failed.",
+                        organization_id=context.organization_id,
+                        task_id=task_id,
+                        step_id=step_id,
+                        error=str(billing_error),
+                    )
+                    status = BlockStatus.failed
+                    failure_reason = str(billing_error)
+                    final_output = None
         else:
             final_output = None
 
@@ -819,6 +843,7 @@ async def _fallback_to_ai_run(
                 BlockStatus(task.status.value),
                 failure_reason=failure_reason,
                 label=cache_key,
+                ai_fallback_triggered=True,
             )
 
         # 5. After successful AI execution, regenerate the script block and create new version