@meetploy/cli 1.20.0 → 1.21.0

package/dist/index.js

@@ -118,6 +118,15 @@ var init_package_manager = __esm({
   "../tools/dist/package-manager.js"() {
   }
 });
+function getWorkflowName(value) {
+  return typeof value === "string" ? value : value.name;
+}
+function getWorkflowTimeout(value) {
+  return typeof value === "string" ? void 0 : value.timeout;
+}
+function getWorkflowStepTimeout(value) {
+  return typeof value === "string" ? void 0 : value.step_timeout;
+}
 function getCompatibilityFlags(config) {
   if (!config.compatibility_flags || config.compatibility_flags.length === 0) {
     return DEFAULT_COMPATIBILITY_FLAGS;
@@ -163,6 +172,47 @@ function validateCronBindings(bindings, configFile) {
     }
   }
 }
+function validateWorkflowBindings(bindings, configFile) {
+  if (bindings === void 0) {
+    return;
+  }
+  for (const [bindingName, value] of Object.entries(bindings)) {
+    if (!BINDING_NAME_REGEX.test(bindingName)) {
+      throw new Error(`Invalid workflow binding name '${bindingName}' in ${configFile}. Binding names must be uppercase with underscores (e.g., ORDER_FLOW)`);
+    }
+    if (typeof value === "string") {
+      if (!RESOURCE_NAME_REGEX.test(value)) {
+        throw new Error(`Invalid workflow resource name '${value}' for binding '${bindingName}' in ${configFile}. Resource names must be lowercase with underscores (e.g., order_processing)`);
+      }
+    } else if (typeof value === "object" && value !== null) {
+      if (typeof value.name !== "string") {
+        throw new Error(`Workflow binding '${bindingName}' in ${configFile} must have a 'name' field`);
+      }
+      if (!RESOURCE_NAME_REGEX.test(value.name)) {
+        throw new Error(`Invalid workflow resource name '${value.name}' for binding '${bindingName}' in ${configFile}. Resource names must be lowercase with underscores (e.g., order_processing)`);
+      }
+      if (value.timeout !== void 0 && (typeof value.timeout !== "number" || !Number.isFinite(value.timeout) || value.timeout <= 0)) {
+        throw new Error(`'timeout' for workflow binding '${bindingName}' in ${configFile} must be a positive number (seconds)`);
+      }
+      if (value.timeout !== void 0 && value.timeout > MAX_WORKFLOW_TIMEOUT_S) {
+        throw new Error(`'timeout' for workflow binding '${bindingName}' in ${configFile} exceeds maximum of ${MAX_WORKFLOW_TIMEOUT_S} seconds (60 minutes)`);
+      }
+      if (value.step_timeout !== void 0) {
+        if (typeof value.step_timeout !== "number" || !Number.isFinite(value.step_timeout) || value.step_timeout <= 0) {
+          throw new Error(`'step_timeout' for workflow binding '${bindingName}' in ${configFile} must be a positive number (seconds)`);
+        }
+        if (value.step_timeout > MAX_WORKFLOW_TIMEOUT_S) {
+          throw new Error(`'step_timeout' for workflow binding '${bindingName}' in ${configFile} exceeds maximum of ${MAX_WORKFLOW_TIMEOUT_S} seconds (60 minutes)`);
+        }
+        if (value.timeout !== void 0 && value.step_timeout > value.timeout) {
+          throw new Error(`'step_timeout' for workflow binding '${bindingName}' in ${configFile} cannot exceed its 'timeout' of ${value.timeout} seconds`);
+        }
+      }
+    } else {
+      throw new Error(`Workflow binding '${bindingName}' in ${configFile} must be a string or object with 'name'`);
+    }
+  }
+}
 function validateRelativePath(path, fieldName, configFile) {
   if (path === void 0) {
     return void 0;
@@ -217,7 +267,7 @@ function validatePloyConfig(config, configFile = "ploy.yaml", options = {}) {
   validateBindings(config.cache, "cache", configFile);
   validateBindings(config.state, "state", configFile);
   validateBindings(config.fs, "fs", configFile);
-  validateBindings(config.workflow, "workflow", configFile);
+  validateWorkflowBindings(config.workflow, configFile);
   validateCronBindings(config.cron, configFile);
   validateBindings(config.timer, "timer", configFile);
   if (config.ai !== void 0 && typeof config.ai !== "boolean") {
@@ -357,10 +407,13 @@ function getWorkerEntryPoint(projectDir, config) {
   }
   throw new Error("Could not find worker entry point. Specify 'main' in ploy.yaml");
 }
-var readFileAsync, DEFAULT_COMPATIBILITY_FLAGS, DEFAULT_COMPATIBILITY_DATE, BINDING_NAME_REGEX, RESOURCE_NAME_REGEX, CRON_EXPRESSION_REGEX;
+var readFileAsync, MAX_WORKFLOW_TIMEOUT_S, DEFAULT_WORKFLOW_TIMEOUT_S, DEFAULT_STEP_TIMEOUT_S, DEFAULT_COMPATIBILITY_FLAGS, DEFAULT_COMPATIBILITY_DATE, BINDING_NAME_REGEX, RESOURCE_NAME_REGEX, CRON_EXPRESSION_REGEX;
 var init_ploy_config = __esm({
   "../tools/dist/ploy-config.js"() {
     readFileAsync = promisify(readFile$1);
+    MAX_WORKFLOW_TIMEOUT_S = 60 * 60;
+    DEFAULT_WORKFLOW_TIMEOUT_S = 10 * 60;
+    DEFAULT_STEP_TIMEOUT_S = 2 * 60;
     DEFAULT_COMPATIBILITY_FLAGS = ["nodejs_compat_v2"];
     DEFAULT_COMPATIBILITY_DATE = "2025-04-02";
     BINDING_NAME_REGEX = /^[A-Z][A-Z0-9_]*$/;
@@ -374,12 +427,18 @@ var cli_exports = {};
 __export(cli_exports, {
   DEFAULT_COMPATIBILITY_DATE: () => DEFAULT_COMPATIBILITY_DATE,
   DEFAULT_COMPATIBILITY_FLAGS: () => DEFAULT_COMPATIBILITY_FLAGS,
+  DEFAULT_STEP_TIMEOUT_S: () => DEFAULT_STEP_TIMEOUT_S,
+  DEFAULT_WORKFLOW_TIMEOUT_S: () => DEFAULT_WORKFLOW_TIMEOUT_S,
+  MAX_WORKFLOW_TIMEOUT_S: () => MAX_WORKFLOW_TIMEOUT_S,
   detectMonorepo: () => detectMonorepo,
   getAddDevDependencyCommand: () => getAddDevDependencyCommand,
   getCompatibilityDate: () => getCompatibilityDate,
   getCompatibilityFlags: () => getCompatibilityFlags,
   getRunCommand: () => getRunCommand,
   getWorkerEntryPoint: () => getWorkerEntryPoint,
+  getWorkflowName: () => getWorkflowName,
+  getWorkflowStepTimeout: () => getWorkflowStepTimeout,
+  getWorkflowTimeout: () => getWorkflowTimeout,
   hasBindings: () => hasBindings,
   isPnpmWorkspace: () => isPnpmWorkspace,
   loadDotEnvSync: () => loadDotEnvSync,
@@ -398,6 +457,26 @@ var init_cli = __esm({
   }
 });
 
+// ../emulator/dist/config/ploy-config.js
+function readPloyConfig2(projectDir, configPath) {
+  const config = readPloyConfigSync(projectDir, configPath);
+  if (!config.kind) {
+    throw new Error(`Missing required field 'kind' in ${configPath ?? "ploy.yaml"}`);
+  }
+  if (config.kind !== "dynamic" && config.kind !== "worker") {
+    throw new Error(`Invalid kind '${config.kind}' in ${configPath ?? "ploy.yaml"}. Must be 'dynamic' or 'worker'`);
+  }
+  return config;
+}
+function getWorkerEntryPoint2(projectDir, config) {
+  return getWorkerEntryPoint(projectDir, config);
+}
+var init_ploy_config2 = __esm({
+  "../emulator/dist/config/ploy-config.js"() {
+    init_cli();
+  }
+});
+
 // ../emulator/dist/runtime/cache-runtime.js
 var CACHE_RUNTIME_CODE;
 var init_cache_runtime = __esm({
@@ -458,10 +537,10 @@ export function initializeCache(cacheName: string, serviceUrl: string): CacheBin
   }
 });
 
-// ../shared/dist/d1-runtime.js
+// ../shared/dist/db-runtime.js
 var DB_RUNTIME_CODE, DB_RUNTIME_CODE_PRODUCTION;
-var init_d1_runtime = __esm({
-  "../shared/dist/d1-runtime.js"() {
+var init_db_runtime = __esm({
+  "../shared/dist/db-runtime.js"() {
     DB_RUNTIME_CODE = `
 interface DBResult {
   results: unknown[];
@@ -481,14 +560,14 @@ interface DBPreparedStatement {
   raw: (options?: { columnNames?: boolean }) => Promise<unknown[][]>;
 }
 
-interface DBDatabase {
+interface Database {
   prepare: (query: string) => DBPreparedStatement;
   dump: () => Promise<ArrayBuffer>;
   batch: (statements: DBPreparedStatement[]) => Promise<DBResult[]>;
   exec: (query: string) => Promise<DBResult>;
 }
 
-export function initializeDB(bindingName: string, serviceUrl: string): DBDatabase {
+export function initializeDB(bindingName: string, serviceUrl: string): Database {
   return {
     prepare(query: string): DBPreparedStatement {
       let boundParams: unknown[] = [];
@@ -760,7 +839,7 @@ var init_url_validation = __esm({
 // ../shared/dist/index.js
 var init_dist = __esm({
   "../shared/dist/index.js"() {
-    init_d1_runtime();
+    init_db_runtime();
     init_error();
     init_health_check();
     init_trace_event();
@@ -771,7 +850,7 @@ var init_dist = __esm({
 });
 
 // ../emulator/dist/runtime/db-runtime.js
-var init_db_runtime = __esm({
+var init_db_runtime2 = __esm({
   "../emulator/dist/runtime/db-runtime.js"() {
     init_dist();
   }
@@ -1333,7 +1412,8 @@ function generateWrapperCode(config, mockServiceUrl, envVars) {
   }
   if (config.workflow) {
     imports.push('import { initializeWorkflow, createStepContext, executeWorkflow } from "__ploy_workflow_runtime__";');
-    for (const [bindingName, workflowName] of Object.entries(config.workflow)) {
+    for (const [bindingName, value] of Object.entries(config.workflow)) {
+      const workflowName = getWorkflowName(value);
       bindings.push(`  ${bindingName}: initializeWorkflow("${workflowName}", "${mockServiceUrl}"),`);
     }
   }
@@ -1608,8 +1688,9 @@ async function bundleWorker(options) {
 var NODE_BUILTINS;
 var init_bundler = __esm({
   "../emulator/dist/bundler/bundler.js"() {
+    init_ploy_config2();
     init_cache_runtime();
-    init_db_runtime();
+    init_db_runtime2();
     init_fs_runtime();
     init_queue_runtime();
     init_state_runtime();
@@ -1671,6 +1752,9 @@ function log(message) {
 function success(message) {
   console.log(`${COLORS.dim}[${timestamp()}]${COLORS.reset} ${COLORS.green}[ploy]${COLORS.reset} ${message}`);
 }
+function warn(message) {
+  console.log(`${COLORS.dim}[${timestamp()}]${COLORS.reset} ${COLORS.yellow}[ploy]${COLORS.reset} ${message}`);
+}
 function error(message) {
   console.error(`${COLORS.dim}[${timestamp()}]${COLORS.reset} ${COLORS.red}[ploy]${COLORS.reset} ${message}`);
 }
@@ -1802,26 +1886,6 @@ var init_env = __esm({
     init_cli();
   }
 });
-
-// ../emulator/dist/config/ploy-config.js
-function readPloyConfig2(projectDir, configPath) {
-  const config = readPloyConfigSync(projectDir, configPath);
-  if (!config.kind) {
-    throw new Error(`Missing required field 'kind' in ${configPath ?? "ploy.yaml"}`);
-  }
-  if (config.kind !== "dynamic" && config.kind !== "worker") {
-    throw new Error(`Invalid kind '${config.kind}' in ${configPath ?? "ploy.yaml"}. Must be 'dynamic' or 'worker'`);
-  }
-  return config;
-}
-function getWorkerEntryPoint2(projectDir, config) {
-  return getWorkerEntryPoint(projectDir, config);
-}
-var init_ploy_config2 = __esm({
-  "../emulator/dist/config/ploy-config.js"() {
-    init_cli();
-  }
-});
 function generateWorkerdConfig(options) {
   const { port, mockServicePort } = options;
   const services = [
@@ -2566,7 +2630,7 @@ function createDashboardRoutes(app, dbManager2, config) {
       return c.json({ error: "Query is required" }, 400);
     }
     try {
-      const db = dbManager2.getD1Database(resourceName);
+      const db = dbManager2.getDatabase(resourceName);
       const startTime = Date.now();
       const stmt = db.prepare(query);
       const isSelect = query.trim().toUpperCase().startsWith("SELECT");
@@ -2604,7 +2668,7 @@ function createDashboardRoutes(app, dbManager2, config) {
       return c.json({ error: `Database binding '${binding}' not found` }, 404);
     }
     try {
-      const db = dbManager2.getD1Database(resourceName);
+      const db = dbManager2.getDatabase(resourceName);
       const tables = db.prepare(`SELECT name FROM sqlite_master
 					 WHERE type='table' AND name NOT LIKE 'sqlite_%' AND name NOT LIKE '_litestream_%'
 					 ORDER BY name`).all();
@@ -2623,7 +2687,7 @@ function createDashboardRoutes(app, dbManager2, config) {
     const limit = parseInt(c.req.query("limit") ?? "50", 10);
     const offset = parseInt(c.req.query("offset") ?? "0", 10);
     try {
-      const db = dbManager2.getD1Database(resourceName);
+      const db = dbManager2.getDatabase(resourceName);
       const columnsResult = db.prepare(`PRAGMA table_info("${tableName}")`).all();
       const columns = columnsResult.map((col) => col.name);
       const countResult = db.prepare(`SELECT COUNT(*) as count FROM "${tableName}"`).get();
@@ -2641,7 +2705,7 @@ function createDashboardRoutes(app, dbManager2, config) {
       return c.json({ error: `Database binding '${binding}' not found` }, 404);
     }
     try {
-      const db = dbManager2.getD1Database(resourceName);
+      const db = dbManager2.getDatabase(resourceName);
       const tablesResult = db.prepare(`SELECT name FROM sqlite_master
 					 WHERE type='table' AND name NOT LIKE 'sqlite_%'
 					 ORDER BY name`).all();
@@ -2794,13 +2858,50 @@ function createDashboardRoutes(app, dbManager2, config) {
   app.get("/api/workflow/:binding/executions", (c) => {
     const binding = c.req.param("binding");
     const workflowConfig = config.workflow?.[binding];
-    const limit = parseInt(c.req.query("limit") ?? "20", 10);
+    const limit = Math.min(Math.max(1, parseInt(c.req.query("limit") ?? "20", 10)), 100);
+    const offset = Math.max(0, parseInt(c.req.query("offset") ?? "0", 10));
+    const statusFilter = c.req.query("status")?.toLowerCase() ?? null;
+    const sinceRaw = c.req.query("since") ?? null;
     if (!workflowConfig) {
       return c.json({ error: "Workflow not found" }, 404);
     }
+    const validStatuses = /* @__PURE__ */ new Set([
+      "pending",
+      "running",
+      "completed",
+      "failed",
+      "cancelled"
+    ]);
     try {
       const db = dbManager2.emulatorDb;
-      const workflowName = workflowConfig;
+      const workflowName = getWorkflowName(workflowConfig);
+      let sinceTs = null;
+      if (sinceRaw) {
+        const match = sinceRaw.match(/^(\d+)(s|m|h|d)?$/);
+        if (match) {
+          const val = parseInt(match[1], 10);
+          const unit = match[2] ?? "s";
+          const multipliers = {
+            s: 1,
+            m: 60,
+            h: 3600,
+            d: 86400
+          };
+          sinceTs = Math.floor(Date.now() / 1e3) - val * (multipliers[unit] ?? 1);
+        }
+      }
+      const conditions = ["e.workflow_name = ?"];
+      const queryArgs = [workflowName];
+      if (statusFilter && validStatuses.has(statusFilter)) {
+        conditions.push("e.status = ?");
+        queryArgs.push(statusFilter);
+      }
+      if (sinceTs !== null) {
+        conditions.push("e.created_at >= ?");
+        queryArgs.push(sinceTs);
+      }
+      const where = conditions.join(" AND ");
+      const countRow = db.prepare(`SELECT COUNT(*) as count FROM workflow_executions e WHERE ${where}`).get(...queryArgs);
       const executions = db.prepare(`SELECT
 						e.id,
 						e.workflow_name,
@@ -2812,9 +2913,9 @@ function createDashboardRoutes(app, dbManager2, config) {
 						(SELECT COUNT(*) FROM workflow_steps WHERE execution_id = e.id) as steps_count,
 						(SELECT COUNT(*) FROM workflow_steps WHERE execution_id = e.id AND status = 'completed') as steps_completed
 					 FROM workflow_executions e
-					 WHERE e.workflow_name = ?
+					 WHERE ${where}
 					 ORDER BY e.created_at DESC
-					 LIMIT ?`).all(workflowName, limit);
+					 LIMIT ? OFFSET ?`).all(...queryArgs, limit, offset);
       return c.json({
         executions: executions.map((e) => ({
           id: e.id,
@@ -2826,7 +2927,10 @@ function createDashboardRoutes(app, dbManager2, config) {
           stepsCompleted: e.steps_completed,
           errorMessage: e.error,
           createdAt: new Date(e.created_at * 1e3).toISOString()
-        }))
+        })),
+        total: countRow.count,
+        limit,
+        offset
       });
     } catch (err) {
       return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
@@ -3060,6 +3164,7 @@ function createDashboardRoutes(app, dbManager2, config) {
 var __filename, __dirname, MIME_TYPES;
 var init_dashboard_routes = __esm({
   "../emulator/dist/services/dashboard-routes.js"() {
+    init_ploy_config2();
     __filename = fileURLToPath(import.meta.url);
     __dirname = dirname(__filename);
     MIME_TYPES = {
@@ -3742,7 +3847,7 @@ function createWorkflowHandlers(db, workerUrl) {
       }
       const now = Math.floor(Date.now() / 1e3);
       if (existing) {
-        db.prepare(`UPDATE workflow_steps SET status = 'running' WHERE execution_id = ? AND step_name = ?`).run(executionId, stepName);
+        db.prepare(`UPDATE workflow_steps SET status = 'running', error = NULL, created_at = ? WHERE execution_id = ? AND step_name = ? AND step_index = ?`).run(now, executionId, stepName, stepIndex);
       } else {
         db.prepare(`INSERT INTO workflow_steps (execution_id, step_name, step_index, status, created_at)
 					 VALUES (?, ?, ?, 'running', ?)`).run(executionId, stepName, stepIndex, now);
@@ -3756,10 +3861,16 @@ function createWorkflowHandlers(db, workerUrl) {
   const stepCompleteHandler = async (c) => {
     try {
       const body = await c.req.json();
-      const { executionId, stepName, output, durationMs } = body;
-      db.prepare(`UPDATE workflow_steps
-				 SET status = 'completed', output = ?, duration_ms = ?
-				 WHERE execution_id = ? AND step_name = ?`).run(JSON.stringify(output), durationMs, executionId, stepName);
+      const { executionId, stepName, stepIndex, output, durationMs } = body;
+      if (stepIndex !== void 0) {
+        db.prepare(`UPDATE workflow_steps
+					 SET status = 'completed', output = ?, duration_ms = ?
+					 WHERE execution_id = ? AND step_name = ? AND step_index = ?`).run(JSON.stringify(output), durationMs, executionId, stepName, stepIndex);
+      } else {
+        db.prepare(`UPDATE workflow_steps
+					 SET status = 'completed', output = ?, duration_ms = ?
+					 WHERE execution_id = ? AND step_name = ?`).run(JSON.stringify(output), durationMs, executionId, stepName);
+      }
       return c.json({ success: true });
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -3769,10 +3880,16 @@ function createWorkflowHandlers(db, workerUrl) {
   const stepFailHandler = async (c) => {
     try {
       const body = await c.req.json();
-      const { executionId, stepName, error: error2, durationMs } = body;
-      db.prepare(`UPDATE workflow_steps
-				 SET status = 'failed', error = ?, duration_ms = ?
-				 WHERE execution_id = ? AND step_name = ?`).run(error2, durationMs, executionId, stepName);
+      const { executionId, stepName, stepIndex, error: error2, durationMs } = body;
+      if (stepIndex !== void 0) {
+        db.prepare(`UPDATE workflow_steps
+					 SET status = 'failed', error = ?, duration_ms = ?
+					 WHERE execution_id = ? AND step_name = ? AND step_index = ?`).run(error2, durationMs, executionId, stepName, stepIndex);
+      } else {
+        db.prepare(`UPDATE workflow_steps
+					 SET status = 'failed', error = ?, duration_ms = ?
+					 WHERE execution_id = ? AND step_name = ?`).run(error2, durationMs, executionId, stepName);
+      }
       return c.json({ success: true });
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -3818,14 +3935,124 @@ function createWorkflowHandlers(db, workerUrl) {
     failHandler
   };
 }
+function startWorkflowTimeoutEnforcement(db, intervalMs = 5e3, timeouts) {
+  let isRunning = false;
+  return setInterval(() => void (async () => {
+    if (isRunning) {
+      return;
+    }
+    isRunning = true;
+    try {
+      const now = Math.floor(Date.now() / 1e3);
+      const allTimeouts = [
+        timeouts.defaultTimeoutS,
+        ...Object.values(timeouts.perWorkflow)
+      ];
+      const minTimeoutS = Math.min(...allTimeouts);
+      const queryThreshold = now - minTimeoutS;
+      const timedOutCandidates = db.prepare(`SELECT id, workflow_name, started_at FROM workflow_executions
+							 WHERE status = 'running' AND started_at < ?`).all(queryThreshold);
+      for (const execution of timedOutCandidates) {
+        const timeoutS = timeouts.perWorkflow[execution.workflow_name] ?? timeouts.defaultTimeoutS;
+        const threshold = now - timeoutS;
+        if (execution.started_at >= threshold) {
+          continue;
+        }
+        db.prepare(`UPDATE workflow_executions
+							 SET status = 'failed', error = ?, completed_at = ?
+							 WHERE id = ? AND status = 'running'`).run(`Workflow exceeded timeout of ${timeoutS}s`, now, execution.id);
+      }
+      const allStepTimeouts = [
+        timeouts.defaultStepTimeoutS,
+        ...Object.values(timeouts.perWorkflowStep)
+      ];
+      const minStepTimeoutS = Math.min(...allStepTimeouts);
+      const stepQueryThreshold = now - minStepTimeoutS;
+      const timedOutSteps = db.prepare(`SELECT ws.id, ws.execution_id, ws.step_name, ws.step_index, ws.created_at, we.workflow_name
+							 FROM workflow_steps ws
+							 JOIN workflow_executions we ON we.id = ws.execution_id
+							 WHERE ws.status = 'running' AND ws.created_at < ?`).all(stepQueryThreshold);
+      for (const step of timedOutSteps) {
+        const stepTimeoutS = timeouts.perWorkflowStep[step.workflow_name] ?? timeouts.defaultStepTimeoutS;
+        const stepThreshold = now - stepTimeoutS;
+        if (step.created_at >= stepThreshold) {
+          continue;
+        }
+        db.transaction(() => {
+          db.prepare(`UPDATE workflow_steps
+								 SET status = 'failed', error = ?
+								 WHERE id = ? AND status = 'running'`).run(`Step exceeded timeout of ${stepTimeoutS}s`, step.id);
+          db.prepare(`UPDATE workflow_executions
+								 SET status = 'failed', error = ?, completed_at = ?
+								 WHERE id = ? AND status = 'running'`).run(`Step '${step.step_name}' exceeded timeout of ${stepTimeoutS}s`, now, step.execution_id);
+        })();
+      }
+    } catch (err) {
+      warn(`Failed to enforce workflow timeouts: ${err instanceof Error ? err.message : String(err)}`);
+    } finally {
+      isRunning = false;
+    }
+  })(), intervalMs);
+}
+function startStalledWorkflowRecovery(db, workerUrl, intervalMs = 5e3, stallTimeoutS = DEFAULT_STALL_TIMEOUT_S) {
+  let isRunning = false;
+  return setInterval(() => void (async () => {
+    if (isRunning) {
+      return;
+    }
+    isRunning = true;
+    try {
+      const now = Math.floor(Date.now() / 1e3);
+      const queryThreshold = now - stallTimeoutS;
+      const stalledExecutions = db.prepare(`SELECT id, workflow_name, input, started_at FROM workflow_executions
+							 WHERE status = 'running' AND started_at < ?`).all(queryThreshold);
+      for (const execution of stalledExecutions) {
+        let input = null;
+        if (execution.input) {
+          try {
+            input = JSON.parse(execution.input);
+          } catch {
+            db.prepare(`UPDATE workflow_executions SET status = 'failed', error = 'Malformed workflow input payload', completed_at = ? WHERE id = ?`).run(now, execution.id);
+            continue;
+          }
+        }
+        db.prepare(`UPDATE workflow_steps SET status = 'pending', error = NULL
+							 WHERE execution_id = ? AND status = 'running'`).run(execution.id);
+        try {
+          const response = await fetch(workerUrl, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              "X-Ploy-Workflow-Execution": "true",
+              "X-Ploy-Workflow-Name": execution.workflow_name,
+              "X-Ploy-Execution-Id": execution.id
+            },
+            body: JSON.stringify(input)
+          });
+          if (response.ok) {
+            db.prepare(`UPDATE workflow_executions SET started_at = ? WHERE id = ?`).run(Math.floor(Date.now() / 1e3), execution.id);
+          }
+        } catch {
+        }
+      }
+    } catch (err) {
+      warn(`Failed to recover stalled workflows: ${err instanceof Error ? err.message : String(err)}`);
+    } finally {
+      isRunning = false;
+    }
+  })(), intervalMs);
+}
+var DEFAULT_STALL_TIMEOUT_S;
 var init_workflow_service = __esm({
   "../emulator/dist/services/workflow-service.js"() {
+    init_logger();
+    DEFAULT_STALL_TIMEOUT_S = 100 * 60;
   }
 });
 async function startMockServer(dbManager2, config, options = {}) {
   const app = new Hono();
   if (config.db) {
-    const dbHandler = createDbHandler(dbManager2.getD1Database);
+    const dbHandler = createDbHandler(dbManager2.getDatabase);
     app.post("/db", dbHandler);
   }
   if (config.queue) {
@@ -3836,6 +4063,8 @@ async function startMockServer(dbManager2, config, options = {}) {
     app.post("/queue/ack", queueHandlers.ackHandler);
     app.post("/queue/retry", queueHandlers.retryHandler);
   }
+  let stalledRecoveryInterval;
+  let timeoutEnforcementInterval;
   if (config.workflow) {
     const workflowHandlers = createWorkflowHandlers(dbManager2.emulatorDb, options.workerUrl);
     app.post("/workflow/trigger", workflowHandlers.triggerHandler);
@@ -3846,6 +4075,28 @@ async function startMockServer(dbManager2, config, options = {}) {
     app.post("/workflow/step/fail", workflowHandlers.stepFailHandler);
     app.post("/workflow/complete", workflowHandlers.completeHandler);
     app.post("/workflow/fail", workflowHandlers.failHandler);
+    const perWorkflow = {};
+    const perWorkflowStep = {};
+    for (const [, value] of Object.entries(config.workflow)) {
+      const workflowName = getWorkflowName(value);
+      const timeout = getWorkflowTimeout(value);
+      const stepTimeout = getWorkflowStepTimeout(value);
+      if (timeout !== void 0) {
+        perWorkflow[workflowName] = timeout;
+      }
+      if (stepTimeout !== void 0) {
+        perWorkflowStep[workflowName] = stepTimeout;
+      }
+    }
+    timeoutEnforcementInterval = startWorkflowTimeoutEnforcement(dbManager2.emulatorDb, 5e3, {
+      perWorkflow,
+      perWorkflowStep,
+      defaultTimeoutS: DEFAULT_WORKFLOW_TIMEOUT_S,
+      defaultStepTimeoutS: DEFAULT_STEP_TIMEOUT_S
+    });
+    if (options.workerUrl) {
+      stalledRecoveryInterval = startStalledWorkflowRecovery(dbManager2.emulatorDb, options.workerUrl, 5e3, DEFAULT_STALL_TIMEOUT_S);
+    }
   }
   if (config.cache) {
     const cacheHandlers = createCacheHandlers(dbManager2.emulatorDb);
@@ -3893,6 +4144,12 @@ async function startMockServer(dbManager2, config, options = {}) {
       resolve({
         port: info.port,
         close: () => new Promise((res) => {
+          if (stalledRecoveryInterval) {
+            clearInterval(stalledRecoveryInterval);
+          }
+          if (timeoutEnforcementInterval) {
+            clearInterval(timeoutEnforcementInterval);
+          }
           server.close(() => {
             res();
           });
@@ -3904,6 +4161,7 @@ async function startMockServer(dbManager2, config, options = {}) {
 var DEFAULT_MOCK_SERVER_PORT;
 var init_mock_server = __esm({
   "../emulator/dist/services/mock-server.js"() {
+    init_ploy_config2();
     init_paths();
     init_auth_service();
     init_cache_service();
@@ -3980,29 +4238,29 @@ var init_sqlite_db = __esm({
 });
 function initializeDatabases(projectDir) {
   const dataDir = ensureDataDir(projectDir);
-  const d1Databases = /* @__PURE__ */ new Map();
+  const databases = /* @__PURE__ */ new Map();
   const emulatorDb = openDatabase(join(dataDir, "emulator.db"));
   emulatorDb.pragma("journal_mode = WAL");
   emulatorDb.exec(EMULATOR_SCHEMA);
-  function getD1Database(bindingName) {
-    let db = d1Databases.get(bindingName);
+  function getDatabase(bindingName) {
+    let db = databases.get(bindingName);
     if (!db) {
       db = openDatabase(join(dataDir, "db", `${bindingName}.db`));
       db.pragma("journal_mode = WAL");
-      d1Databases.set(bindingName, db);
+      databases.set(bindingName, db);
     }
     return db;
   }
   function close() {
     emulatorDb.close();
-    for (const db of d1Databases.values()) {
+    for (const db of databases.values()) {
       db.close();
     }
-    d1Databases.clear();
+    databases.clear();
   }
   return {
     emulatorDb,
-    getD1Database,
+    getDatabase,
     close
   };
 }
@@ -4477,7 +4735,7 @@ var init_emulator = __esm({
 });
 
 // ../emulator/dist/nextjs-dev.js
-function createDevD1(databaseId, apiUrl) {
+function createDevDB(databaseId, apiUrl) {
   return {
     async dump() {
       const response = await fetch(`${apiUrl}/db`, {
@@ -4642,7 +4900,7 @@ async function initPloyForDev(config) {
     const env2 = {};
     if (hasDbBindings2 && ployConfig2.db) {
       for (const [bindingName, databaseId] of Object.entries(ployConfig2.db)) {
-        env2[bindingName] = createDevD1(databaseId, cliMockServerUrl);
+        env2[bindingName] = createDevDB(databaseId, cliMockServerUrl);
       }
     }
     if (hasAuthConfig2) {
@@ -4694,7 +4952,7 @@ async function initPloyForDev(config) {
   const env = {};
   if (hasDbBindings && ployConfig.db) {
     for (const [bindingName, databaseId] of Object.entries(ployConfig.db)) {
-      env[bindingName] = createDevD1(databaseId, apiUrl);
+      env[bindingName] = createDevDB(databaseId, apiUrl);
     }
   }
   if (hasAuthConfig) {
@@ -4827,7 +5085,7 @@ var init_dist2 = __esm({
     init_emulator();
     init_nextjs_dev();
     init_dev_dashboard();
-    init_db_runtime();
+    init_db_runtime2();
   }
 });
 var CONFIG_DIR = join(homedir(), ".ploy");
@@ -6316,7 +6574,7 @@ ${varProps}
   }
   if (config.db) {
     for (const bindingName of Object.keys(config.db)) {
-      properties.push(`	${bindingName}: D1Database;`);
+      properties.push(`	${bindingName}: Database;`);
     }
   }
   if (config.queue) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@meetploy/cli",
-	"version": "1.20.0",
+	"version": "1.21.0",
 	"private": false,
 	"repository": {
 		"type": "git",