@fragno-dev/workflows 0.0.1 → 0.0.3

package/dist/node/runner/task.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"task.js","names":["dbNow","refreshPromise: Promise<void> | null","timer: ReturnType<typeof setInterval> | null"],"sources":["../../../src/runner/task.ts"],"sourcesContent":["// Task leasing and task/instance transition helpers for the workflow runner.\n\nimport { ConcurrencyConflictError } from \"@fragno-dev/db\";\nimport { FragnoId } from \"@fragno-dev/db/schema\";\nimport type { FragnoRuntime } from \"@fragno-dev/core\";\nimport { workflowsSchema } from \"../schema\";\nimport type {\n  RunHandlerTx,\n  WorkflowEventRecord,\n  WorkflowInstanceRecord,\n  WorkflowInstanceUpdate,\n  WorkflowStepRecord,\n  WorkflowTaskRecord,\n} from \"./types\";\nimport { isPausedStatus, isTerminalStatus } from \"./status\";\nimport type { RunnerMutationBuffer, RunnerState } from \"./state\";\nimport { updateRemoteState } from \"./state\";\n\nconst requireFragnoId = (value: unknown, label: string): FragnoId => {\n  if (value instanceof FragnoId) {\n    return value;\n  }\n  throw new Error(`OCC_REQUIRED_${label}`);\n};\n\ntype TaskContext = {\n  runHandlerTx: RunHandlerTx;\n  time: FragnoRuntime[\"time\"];\n  runnerId: string;\n  leaseMs: number;\n  getDbNow: () => Promise<Date>;\n};\n\nexport const claimTask = async (\n  task: WorkflowTaskRecord,\n  now: Date,\n  ctx: TaskContext,\n): Promise<{\n  task: WorkflowTaskRecord;\n  instance: WorkflowInstanceRecord;\n  steps: WorkflowStepRecord[];\n  events: WorkflowEventRecord[];\n} | null> => {\n  if (!task) {\n    return null;\n  }\n\n  const claimedAt = now;\n  const lockedUntil = new Date(now.getTime() + ctx.leaseMs);\n\n  let outcome;\n  try {\n    outcome = await ctx.runHandlerTx((handlerTx) =>\n      handlerTx()\n        .retrieve(({ forSchema }) =>\n          forSchema(workflowsSchema)\n            .findFirst(\"workflow_task\", (b) =>\n              b.whereIndex(\"primary\", (eb) => eb(\"id\", \"=\", task.id)).join((j) => j.taskInstance()),\n            )\n            .find(\"workflow_step\", (b) =>\n              b.whereIndex(\"idx_workflow_step_instanceRef_runNumber\", (eb) =>\n                eb.and(\n                  eb(\"instanceRef\", \"=\", task.instanceRef),\n                  eb(\"runNumber\", \"=\", task.runNumber),\n                ),\n              ),\n            )\n            .find(\"workflow_event\", (b) =>\n              b\n                .whereIndex(\"idx_workflow_event_instanceRef_runNumber_createdAt\", (eb) =>\n                  eb.and(\n                    eb(\"instanceRef\", \"=\", task.instanceRef),\n                    eb(\"runNumber\", \"=\", task.runNumber),\n                  ),\n                )\n                .orderByIndex(\"idx_workflow_event_instanceRef_runNumber_createdAt\", \"asc\"),\n            ),\n        )\n        .transformRetrieve(([currentTask, steps, events]) => {\n          if (!currentTask) {\n            return { kind: \"noop\" as const };\n          }\n\n          const instance = (\n            currentTask as WorkflowTaskRecord & {\n              taskInstance?: WorkflowInstanceRecord | null;\n            }\n          ).taskInstance;\n\n          if (!instance || instance.runNumber !== currentTask.runNumber) {\n            return { kind: \"delete\" as const, taskId: currentTask.id };\n          }\n\n          if (isTerminalStatus(instance.status)) {\n            return { kind: \"delete\" as const, taskId: currentTask.id };\n          }\n\n          if (isPausedStatus(instance.status)) {\n            return { kind: \"noop\" as const };\n          }\n\n          const hasActiveLease =\n            currentTask.status === \"processing\" && currentTask.lockedUntil\n              ? currentTask.lockedUntil > now\n              : false;\n          const canStealProcessing = currentTask.status === \"processing\" && !hasActiveLease;\n          if (currentTask.status !== \"pending\" && !canStealProcessing) {\n            return { kind: \"noop\" as const };\n          }\n\n          return {\n            kind: \"claim\" as const,\n            task: currentTask,\n            instance,\n            steps,\n            events,\n          };\n        })\n        .mutate(({ forSchema, retrieveResult }) => {\n          if (retrieveResult.kind === \"delete\") {\n            const taskId = retrieveResult.taskId;\n            requireFragnoId(taskId, \"TASK_ID\");\n            forSchema(workflowsSchema).delete(\"workflow_task\", taskId, (b) => b.check());\n            return;\n          }\n\n          if (retrieveResult.kind === \"claim\") {\n            const taskId = retrieveResult.task.id;\n            forSchema(workflowsSchema).update(\"workflow_task\", taskId, (b) => {\n              requireFragnoId(taskId, \"TASK_ID\");\n              const builder = b.set({\n                status: \"processing\",\n                lockOwner: ctx.runnerId,\n                lockedUntil,\n                updatedAt: claimedAt,\n              });\n              builder.check();\n              return builder;\n            });\n          }\n        })\n        .transform(({ retrieveResult }) => retrieveResult)\n        .execute(),\n    );\n  } catch (err) {\n    if (err instanceof ConcurrencyConflictError) {\n      return null;\n    }\n    throw err;\n  }\n\n  if (outcome.kind !== \"claim\") {\n    return null;\n  }\n\n  return {\n    task: {\n      ...outcome.task,\n      status: \"processing\",\n      lockOwner: ctx.runnerId,\n      lockedUntil,\n      updatedAt: claimedAt,\n    },\n    instance: outcome.instance,\n    steps: outcome.steps,\n    events: outcome.events,\n  };\n};\n\nexport const commitInstanceAndTask = async (\n  task: WorkflowTaskRecord,\n  instance: WorkflowInstanceRecord,\n  status: string,\n  update: Partial<WorkflowInstanceUpdate>,\n  taskAction:\n    | { kind: \"delete\" }\n    | { kind: \"schedule\"; taskKind: \"wake\" | \"retry\" | \"run\"; runAt: Date },\n  mutations: RunnerMutationBuffer,\n  ctx: Pick<TaskContext, \"runHandlerTx\" | \"time\" | \"getDbNow\">,\n): Promise<boolean> => {\n  const { id: _ignoredInstanceId, ...safeUpdate } = update as WorkflowInstanceRecord;\n  const dbNow = await ctx.getDbNow();\n\n  try {\n    await ctx.runHandlerTx((handlerTx) =>\n      handlerTx()\n        .mutate(({ forSchema }) => {\n          const uow = forSchema(workflowsSchema);\n          const instanceId = instance.id;\n          uow.update(\"workflow_instance\", instanceId, (b) => {\n            requireFragnoId(instanceId, \"INSTANCE_ID\");\n            const builder = b.set({\n              ...safeUpdate,\n              status,\n              updatedAt: dbNow,\n            });\n            builder.check();\n            return builder;\n          });\n\n          if (taskAction.kind === \"delete\") {\n            uow.delete(\"workflow_task\", task.id);\n          } else {\n            uow.update(\"workflow_task\", task.id, (b) =>\n              b.set({\n                kind: taskAction.taskKind,\n                runAt: taskAction.runAt,\n                status: \"pending\",\n                attempts: 0,\n                lastError: null,\n                lockOwner: null,\n                lockedUntil: null,\n                updatedAt: dbNow,\n              }),\n            );\n            const reason =\n              taskAction.taskKind === \"retry\"\n                ? \"retry\"\n                : taskAction.taskKind === \"wake\"\n                  ? \"wake\"\n                  : \"create\";\n            uow.triggerHook(\n              \"onWorkflowEnqueued\",\n              {\n                workflowName: task.workflowName,\n                instanceId: task.instanceId,\n                reason,\n              },\n              { processAt: taskAction.runAt },\n            );\n          }\n\n          for (const [, createData] of mutations.stepCreates) {\n            uow.create(\"workflow_step\", createData);\n          }\n\n          for (const [, updateEntry] of mutations.stepUpdates) {\n            uow.update(\"workflow_step\", updateEntry.id, (b) => {\n              requireFragnoId(updateEntry.id, \"STEP_ID\");\n              const builder = b.set(updateEntry.data);\n              builder.check();\n              return builder;\n            });\n          }\n\n          for (const [, eventUpdate] of mutations.eventUpdates) {\n            uow.update(\"workflow_event\", eventUpdate.id, (b) => {\n              requireFragnoId(eventUpdate.id, \"EVENT_ID\");\n              const builder = b.set(eventUpdate.data);\n              builder.check();\n              return builder;\n            });\n          }\n\n          for (const log of mutations.logs) {\n            uow.create(\"workflow_log\", log);\n          }\n        })\n        .execute(),\n    );\n    return true;\n  } catch (err) {\n    if (err instanceof ConcurrencyConflictError) {\n      const fallback = await ctx.runHandlerTx((handlerTx) =>\n        handlerTx()\n          .retrieve(({ forSchema }) =>\n            forSchema(workflowsSchema).findFirst(\"workflow_instance\", (b) =>\n              b.whereIndex(\"idx_workflow_instance_workflowName_instanceId\", (eb) =>\n                eb.and(\n                  eb(\"workflowName\", \"=\", instance.workflowName),\n                  eb(\"instanceId\", \"=\", instance.instanceId),\n                ),\n              ),\n            ),\n          )\n          .transformRetrieve(([current]) => {\n            if (!current) {\n              return { kind: \"deleteTask\" as const };\n            }\n\n            if (current.runNumber !== instance.runNumber) {\n              return { kind: \"deleteTask\" as const };\n            }\n\n            if (isTerminalStatus(current.status)) {\n              return { kind: \"deleteTask\" as const };\n            }\n\n            if (\n              current.pauseRequested ||\n              current.status === \"waitingForPause\" ||\n              current.status === \"paused\"\n            ) {\n              return { kind: \"pause\" as const, instance: current };\n            }\n\n            return { kind: \"noop\" as const };\n          })\n          .mutate(({ forSchema, retrieveResult }) => {\n            const uow = forSchema(workflowsSchema);\n\n            if (retrieveResult.kind === \"deleteTask\") {\n              uow.delete(\"workflow_task\", task.id);\n              return;\n            }\n\n            if (retrieveResult.kind !== \"pause\") {\n              return;\n            }\n\n            const instanceId = retrieveResult.instance.id;\n            uow.update(\"workflow_instance\", instanceId, (b) => {\n              requireFragnoId(instanceId, \"INSTANCE_ID\");\n              const builder = b.set({\n                status: \"paused\",\n                pauseRequested: false,\n                updatedAt: dbNow,\n              });\n              builder.check();\n              return builder;\n            });\n\n            uow.delete(\"workflow_task\", task.id);\n            for (const [, createData] of mutations.stepCreates) {\n              uow.create(\"workflow_step\", createData);\n            }\n\n            for (const [, updateEntry] of mutations.stepUpdates) {\n              uow.update(\"workflow_step\", updateEntry.id, (b) => {\n                requireFragnoId(updateEntry.id, \"STEP_ID\");\n                const builder = b.set(updateEntry.data);\n                builder.check();\n                return builder;\n              });\n            }\n\n            for (const [, eventUpdate] of mutations.eventUpdates) {\n              uow.update(\"workflow_event\", eventUpdate.id, (b) => {\n                requireFragnoId(eventUpdate.id, \"EVENT_ID\");\n                const builder = b.set(eventUpdate.data);\n                builder.check();\n                return builder;\n              });\n            }\n\n            for (const log of mutations.logs) {\n              uow.create(\"workflow_log\", log);\n            }\n          })\n          .transform(({ retrieveResult }) => retrieveResult)\n          .execute(),\n      );\n\n      return fallback.kind === \"pause\";\n    }\n    throw err;\n  }\n};\n\nexport const deleteTask = async (\n  task: WorkflowTaskRecord,\n  ctx: Pick<TaskContext, \"runHandlerTx\">,\n): Promise<void> => {\n  try {\n    await ctx.runHandlerTx((handlerTx) =>\n      handlerTx()\n        .mutate(({ forSchema }) => {\n          // Delete without a version check to avoid stale ID conflicts.\n          forSchema(workflowsSchema).delete(\"workflow_task\", task.id);\n        })\n        .execute(),\n    );\n  } catch (err) {\n    if (err instanceof ConcurrencyConflictError) {\n      return;\n    }\n    throw err;\n  }\n};\n\nexport const renewTaskLease = async (\n  taskId: WorkflowTaskRecord[\"id\"],\n  ctx: TaskContext,\n): Promise<{ ok: boolean; instance: WorkflowInstanceRecord | null }> => {\n  const dbNow = await ctx.getDbNow();\n  const lockedUntil = new Date(dbNow.getTime() + ctx.leaseMs);\n  try {\n    const outcome = await ctx.runHandlerTx((handlerTx) =>\n      handlerTx()\n        .retrieve(({ forSchema }) =>\n          forSchema(workflowsSchema).findFirst(\"workflow_task\", (b) =>\n            b.whereIndex(\"primary\", (eb) => eb(\"id\", \"=\", taskId)).join((j) => j.taskInstance()),\n          ),\n        )\n        .transformRetrieve(([currentTask]) => {\n          const instance = currentTask?.taskInstance ?? null;\n          const task = currentTask ?? null;\n          const canRenew =\n            !!task && task.status === \"processing\" && task.lockOwner === ctx.runnerId;\n          return { task, instance, canRenew };\n        })\n        .mutate(({ forSchema, retrieveResult }) => {\n          if (!retrieveResult.task || !retrieveResult.canRenew) {\n            return;\n          }\n          forSchema(workflowsSchema).update(\"workflow_task\", taskId, (b) =>\n            b.set({\n              lockedUntil,\n              updatedAt: dbNow,\n            }),\n          );\n        })\n        .transform(({ retrieveResult }) => retrieveResult)\n        .execute(),\n    );\n    if (!outcome.task || !outcome.canRenew) {\n      return { ok: false, instance: outcome.instance ?? null };\n    }\n    return { ok: true, instance: outcome.instance };\n  } catch (err) {\n    if (err instanceof ConcurrencyConflictError) {\n      return { ok: false, instance: null };\n    }\n    throw err;\n  }\n};\n\nexport const startTaskLeaseHeartbeat = (\n  task: WorkflowTaskRecord,\n  state: RunnerState,\n  ctx: TaskContext,\n) => {\n  // Heartbeat refreshes the lease and snapshots pause/terminal state for in-memory checks.\n  const intervalMs = Math.max(Math.floor(ctx.leaseMs / 2), 10);\n  let stopped = false;\n  let inFlight = false;\n  let refreshPromise: Promise<void> | null = null;\n  let timer: ReturnType<typeof setInterval> | null = null;\n\n  const applyRefreshResult = (renewed: Awaited<ReturnType<typeof renewTaskLease>>) => {\n    updateRemoteState(state, renewed.instance);\n    if (!renewed.ok) {\n      stopped = true;\n      if (timer) {\n        clearInterval(timer);\n        timer = null;\n      }\n    }\n  };\n\n  const heartbeat = async () => {\n    if (stopped || inFlight) {\n      return;\n    }\n    inFlight = true;\n    try {\n      const renewed = await renewTaskLease(task.id, ctx);\n      applyRefreshResult(renewed);\n    } finally {\n      inFlight = false;\n    }\n  };\n\n  timer = setInterval(() => {\n    void heartbeat();\n  }, intervalMs);\n\n  state.remoteStateRefresh = async () => {\n    if (stopped) {\n      return;\n    }\n    if (refreshPromise) {\n      await refreshPromise;\n      return;\n    }\n\n    refreshPromise = (async () => {\n      const renewed = await renewTaskLease(task.id, ctx);\n      applyRefreshResult(renewed);\n    })();\n\n    try {\n      await refreshPromise;\n    } finally {\n      refreshPromise = null;\n    }\n  };\n\n  return () => {\n    stopped = true;\n    if (timer) {\n      clearInterval(timer);\n      timer = null;\n    }\n  };\n};\n"],"mappings":";;;;;;;AAkBA,MAAM,mBAAmB,OAAgB,UAA4B;AACnE,KAAI,iBAAiB,SACnB,QAAO;AAET,OAAM,IAAI,MAAM,gBAAgB,QAAQ;;AAW1C,MAAa,YAAY,OACvB,MACA,KACA,QAMW;AACX,KAAI,CAAC,KACH,QAAO;CAGT,MAAM,YAAY;CAClB,MAAM,cAAc,IAAI,KAAK,IAAI,SAAS,GAAG,IAAI,QAAQ;CAEzD,IAAI;AACJ,KAAI;AACF,YAAU,MAAM,IAAI,cAAc,cAChC,WAAW,CACR,UAAU,EAAE,gBACX,UAAU,gBAAgB,CACvB,UAAU,kBAAkB,MAC3B,EAAE,WAAW,YAAY,OAAO,GAAG,MAAM,KAAK,KAAK,GAAG,CAAC,CAAC,MAAM,MAAM,EAAE,cAAc,CAAC,CACtF,CACA,KAAK,kBAAkB,MACtB,EAAE,WAAW,4CAA4C,OACvD,GAAG,IACD,GAAG,eAAe,KAAK,KAAK,YAAY,EACxC,GAAG,aAAa,KAAK,KAAK,UAAU,CACrC,CACF,CACF,CACA,KAAK,mBAAmB,MACvB,EACG,WAAW,uDAAuD,OACjE,GAAG,IACD,GAAG,eAAe,KAAK,KAAK,YAAY,EACxC,GAAG,aAAa,KAAK,KAAK,UAAU,CACrC,CACF,CACA,aAAa,sDAAsD,MAAM,CAC7E,CACJ,CACA,mBAAmB,CAAC,aAAa,OAAO,YAAY;AACnD,OAAI,CAAC,YACH,QAAO,EAAE,MAAM,QAAiB;GAGlC,MAAM,WACJ,YAGA;AAEF,OAAI,CAAC,YAAY,SAAS,cAAc,YAAY,UAClD,QAAO;IAAE,MAAM;IAAmB,QAAQ,YAAY;IAAI;AAG5D,OAAI,iBAAiB,SAAS,OAAO,CACnC,QAAO;IAAE,MAAM;IAAmB,QAAQ,YAAY;IAAI;AAG5D,OAAI,eAAe,SAAS,OAAO,CACjC,QAAO,EAAE,MAAM,QAAiB;GAGlC,MAAM,iBACJ,YAAY,WAAW,gBAAgB,YAAY,cAC/C,YAAY,cAAc,MAC1B;GACN,MAAM,qBAAqB,YAAY,WAAW,gBAAgB,CAAC;AACnE,OAAI,YAAY,WAAW,aAAa,CAAC,mBACvC,QAAO,EAAE,MAAM,QAAiB;AAGlC,UAAO;IACL,MAAM;IACN,MAAM;IACN;IACA;IACA;IACD;IACD,CACD,QAAQ,EAAE,WAAW,qBAAqB;AACzC,OAAI,eAAe,SAAS,UAAU;IACpC,MAAM,SAAS,eAAe;AAC9B,oBAAgB,QAAQ,UAAU;AAClC,cAAU,gBAAgB,CAAC,OAAO,iBAAiB,SAAS,MAAM,EAAE,OAAO,CAAC;AAC5E;;AAGF,OAAI,eAAe,SAAS,SAAS;IACnC,MAAM,SAAS,eAAe,KAAK;AACnC,cAAU,gBAAgB,CAAC,OAAO,iBAAiB,SAAS,MAAM;AAChE,qBAAgB,QAAQ,UAAU;KAClC,MAAM,UAAU,EAAE,IAAI;MACpB,QAAQ;MACR,WAAW,IAAI;MACf;MACA,WAAW;MACZ,CAAC;AACF,aAAQ,OAAO;AACf,YAAO;MACP;;IAEJ,CACD,WAAW,EAAE,qBAAqB,eAAe,CACjD,SAAS,CACb;UACM,KAAK;AACZ,MAAI,eAAe,yBACjB,QAAO;AAET,QAAM;;AAGR,KAAI,QAAQ,SAAS,QACnB,QAAO;AAGT,QAAO;EACL,MAAM;GACJ,GAAG,QAAQ;GACX,QAAQ;GACR,WAAW,IAAI;GACf;GACA,WAAW;GACZ;EACD,UAAU,QAAQ;EAClB,OAAO,QAAQ;EACf,QAAQ,QAAQ;EACjB;;AAGH,MAAa,wBAAwB,OACnC,MACA,UACA,QACA,QACA,YAGA,WACA,QACqB;CACrB,MAAM,EAAE,IAAI,mBAAoB,GAAG,eAAe;CAClD,MAAMA,UAAQ,MAAM,IAAI,UAAU;AAElC,KAAI;AACF,QAAM,IAAI,cAAc,cACtB,WAAW,CACR,QAAQ,EAAE,gBAAgB;GACzB,MAAM,MAAM,UAAU,gBAAgB;GACtC,MAAM,aAAa,SAAS;AAC5B,OAAI,OAAO,qBAAqB,aAAa,MAAM;AACjD,oBAAgB,YAAY,cAAc;IAC1C,MAAM,UAAU,EAAE,IAAI;KACpB,GAAG;KACH;KACA,WAAWA;KACZ,CAAC;AACF,YAAQ,OAAO;AACf,WAAO;KACP;AAEF,OAAI,WAAW,SAAS,SACtB,KAAI,OAAO,iBAAiB,KAAK,GAAG;QAC/B;AACL,QAAI,OAAO,iBAAiB,KAAK,KAAK,MACpC,EAAE,IAAI;KACJ,MAAM,WAAW;KACjB,OAAO,WAAW;KAClB,QAAQ;KACR,UAAU;KACV,WAAW;KACX,WAAW;KACX,aAAa;KACb,WAAWA;KACZ,CAAC,CACH;IACD,MAAM,SACJ,WAAW,aAAa,UACpB,UACA,WAAW,aAAa,SACtB,SACA;AACR,QAAI,YACF,sBACA;KACE,cAAc,KAAK;KACnB,YAAY,KAAK;KACjB;KACD,EACD,EAAE,WAAW,WAAW,OAAO,CAChC;;AAGH,QAAK,MAAM,GAAG,eAAe,UAAU,YACrC,KAAI,OAAO,iBAAiB,WAAW;AAGzC,QAAK,MAAM,GAAG,gBAAgB,UAAU,YACtC,KAAI,OAAO,iBAAiB,YAAY,KAAK,MAAM;AACjD,oBAAgB,YAAY,IAAI,UAAU;IAC1C,MAAM,UAAU,EAAE,IAAI,YAAY,KAAK;AACvC,YAAQ,OAAO;AACf,WAAO;KACP;AAGJ,QAAK,MAAM,GAAG,gBAAgB,UAAU,aACtC,KAAI,OAAO,kBAAkB,YAAY,KAAK,MAAM;AAClD,oBAAgB,YAAY,IAAI,WAAW;IAC3C,MAAM,UAAU,EAAE,IAAI,YAAY,KAAK;AACvC,YAAQ,OAAO;AACf,WAAO;KACP;AAGJ,QAAK,MAAM,OAAO,UAAU,KAC1B,KAAI,OAAO,gBAAgB,IAAI;IAEjC,CACD,SAAS,CACb;AACD,SAAO;UACA,KAAK;AACZ,MAAI,eAAe,yBA2FjB,SA1FiB,MAAM,IAAI,cAAc,cACvC,WAAW,CACR,UAAU,EAAE,gBACX,UAAU,gBAAgB,CAAC,UAAU,sBAAsB,MACzD,EAAE,WAAW,kDAAkD,OAC7D,GAAG,IACD,GAAG,gBAAgB,KAAK,SAAS,aAAa,EAC9C,GAAG,cAAc,KAAK,SAAS,WAAW,CAC3C,CACF,CACF,CACF,CACA,mBAAmB,CAAC,aAAa;AAChC,OAAI,CAAC,QACH,QAAO,EAAE,MAAM,cAAuB;AAGxC,OAAI,QAAQ,cAAc,SAAS,UACjC,QAAO,EAAE,MAAM,cAAuB;AAGxC,OAAI,iBAAiB,QAAQ,OAAO,CAClC,QAAO,EAAE,MAAM,cAAuB;AAGxC,OACE,QAAQ,kBACR,QAAQ,WAAW,qBACnB,QAAQ,WAAW,SAEnB,QAAO;IAAE,MAAM;IAAkB,UAAU;IAAS;AAGtD,UAAO,EAAE,MAAM,QAAiB;IAChC,CACD,QAAQ,EAAE,WAAW,qBAAqB;GACzC,MAAM,MAAM,UAAU,gBAAgB;AAEtC,OAAI,eAAe,SAAS,cAAc;AACxC,QAAI,OAAO,iBAAiB,KAAK,GAAG;AACpC;;AAGF,OAAI,eAAe,SAAS,QAC1B;GAGF,MAAM,aAAa,eAAe,SAAS;AAC3C,OAAI,OAAO,qBAAqB,aAAa,MAAM;AACjD,oBAAgB,YAAY,cAAc;IAC1C,MAAM,UAAU,EAAE,IAAI;KACpB,QAAQ;KACR,gBAAgB;KAChB,WAAWA;KACZ,CAAC;AACF,YAAQ,OAAO;AACf,WAAO;KACP;AAEF,OAAI,OAAO,iBAAiB,KAAK,GAAG;AACpC,QAAK,MAAM,GAAG,eAAe,UAAU,YACrC,KAAI,OAAO,iBAAiB,WAAW;AAGzC,QAAK,MAAM,GAAG,gBAAgB,UAAU,YACtC,KAAI,OAAO,iBAAiB,YAAY,KAAK,MAAM;AACjD,oBAAgB,YAAY,IAAI,UAAU;IAC1C,MAAM,UAAU,EAAE,IAAI,YAAY,KAAK;AACvC,YAAQ,OAAO;AACf,WAAO;KACP;AAGJ,QAAK,MAAM,GAAG,gBAAgB,UAAU,aACtC,KAAI,OAAO,kBAAkB,YAAY,KAAK,MAAM;AAClD,oBAAgB,YAAY,IAAI,WAAW;IAC3C,MAAM,UAAU,EAAE,IAAI,YAAY,KAAK;AACvC,YAAQ,OAAO;AACf,WAAO;KACP;AAGJ,QAAK,MAAM,OAAO,UAAU,KAC1B,KAAI,OAAO,gBAAgB,IAAI;IAEjC,CACD,WAAW,EAAE,qBAAqB,eAAe,CACjD,SAAS,CACb,EAEe,SAAS;AAE3B,QAAM;;;AAIV,MAAa,aAAa,OACxB,MACA,QACkB;AAClB,KAAI;AACF,QAAM,IAAI,cAAc,cACtB,WAAW,CACR,QAAQ,EAAE,gBAAgB;AAEzB,aAAU,gBAAgB,CAAC,OAAO,iBAAiB,KAAK,GAAG;IAC3D,CACD,SAAS,CACb;UACM,KAAK;AACZ,MAAI,eAAe,yBACjB;AAEF,QAAM;;;AAIV,MAAa,iBAAiB,OAC5B,QACA,QACsE;CACtE,MAAMA,UAAQ,MAAM,IAAI,UAAU;CAClC,MAAM,cAAc,IAAI,KAAKA,QAAM,SAAS,GAAG,IAAI,QAAQ;AAC3D,KAAI;EACF,MAAM,UAAU,MAAM,IAAI,cAAc,cACtC,WAAW,CACR,UAAU,EAAE,gBACX,UAAU,gBAAgB,CAAC,UAAU,kBAAkB,MACrD,EAAE,WAAW,YAAY,OAAO,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,MAAM,EAAE,cAAc,CAAC,CACrF,CACF,CACA,mBAAmB,CAAC,iBAAiB;GACpC,MAAM,WAAW,aAAa,gBAAgB;GAC9C,MAAM,OAAO,eAAe;AAG5B,UAAO;IAAE;IAAM;IAAU,UADvB,CAAC,CAAC,QAAQ,KAAK,WAAW,gBAAgB,KAAK,cAAc,IAAI;IAChC;IACnC,CACD,QAAQ,EAAE,WAAW,qBAAqB;AACzC,OAAI,CAAC,eAAe,QAAQ,CAAC,eAAe,SAC1C;AAEF,aAAU,gBAAgB,CAAC,OAAO,iBAAiB,SAAS,MAC1D,EAAE,IAAI;IACJ;IACA,WAAWA;IACZ,CAAC,CACH;IACD,CACD,WAAW,EAAE,qBAAqB,eAAe,CACjD,SAAS,CACb;AACD,MAAI,CAAC,QAAQ,QAAQ,CAAC,QAAQ,SAC5B,QAAO;GAAE,IAAI;GAAO,UAAU,QAAQ,YAAY;GAAM;AAE1D,SAAO;GAAE,IAAI;GAAM,UAAU,QAAQ;GAAU;UACxC,KAAK;AACZ,MAAI,eAAe,yBACjB,QAAO;GAAE,IAAI;GAAO,UAAU;GAAM;AAEtC,QAAM;;;AAIV,MAAa,2BACX,MACA,OACA,QACG;CAEH,MAAM,aAAa,KAAK,IAAI,KAAK,MAAM,IAAI,UAAU,EAAE,EAAE,GAAG;CAC5D,IAAI,UAAU;CACd,IAAI,WAAW;CACf,IAAIC,iBAAuC;CAC3C,IAAIC,QAA+C;CAEnD,MAAM,sBAAsB,YAAwD;AAClF,oBAAkB,OAAO,QAAQ,SAAS;AAC1C,MAAI,CAAC,QAAQ,IAAI;AACf,aAAU;AACV,OAAI,OAAO;AACT,kBAAc,MAAM;AACpB,YAAQ;;;;CAKd,MAAM,YAAY,YAAY;AAC5B,MAAI,WAAW,SACb;AAEF,aAAW;AACX,MAAI;AAEF,sBADgB,MAAM,eAAe,KAAK,IAAI,IAAI,CACvB;YACnB;AACR,cAAW;;;AAIf,SAAQ,kBAAkB;AACxB,EAAK,WAAW;IACf,WAAW;AAEd,OAAM,qBAAqB,YAAY;AACrC,MAAI,QACF;AAEF,MAAI,gBAAgB;AAClB,SAAM;AACN;;AAGF,oBAAkB,YAAY;AAE5B,sBADgB,MAAM,eAAe,KAAK,IAAI,IAAI,CACvB;MACzB;AAEJ,MAAI;AACF,SAAM;YACE;AACR,oBAAiB;;;AAIrB,cAAa;AACX,YAAU;AACV,MAAI,OAAO;AACT,iBAAc,MAAM;AACpB,WAAQ"}

package/dist/node/runner.d.ts

@@ -1,8 +0,0 @@
-import { WorkflowsRunner } from "./workflow.js";
-import { WorkflowsRunnerOptions } from "./runner/types.js";
-
-//#region src/runner.d.ts
-declare function createWorkflowsRunner(runnerOptions: WorkflowsRunnerOptions): WorkflowsRunner;
-//#endregion
-export { createWorkflowsRunner };
-//# sourceMappingURL=runner.d.ts.map

package/dist/node/runner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runner.d.ts","names":[],"sources":["../../src/runner.ts"],"sourcesContent":[],"mappings":";;;;iBA0BgB,qBAAA,gBAAqC,yBAAyB"}

package/dist/node/runner.js

@@ -1,82 +0,0 @@
-import { workflowsSchema } from "./schema.js";
-import { createWorkflowsBindingsForRunner } from "./bindings-runner.js";
-import { DEFAULT_LEASE_MS, DEFAULT_MAX_INSTANCES, DEFAULT_MAX_STEPS, PRIORITY_BY_KIND } from "./runner/constants.js";
-import { runHandlerTx } from "./runner/queries.js";
-import { claimTask, commitInstanceAndTask, deleteTask, startTaskLeaseHeartbeat } from "./runner/task.js";
-import { processTask } from "./runner/process.js";
-
-//#region src/runner.ts
-function createWorkflowsRunner(runnerOptions) {
-	const workflowsByName = /* @__PURE__ */ new Map();
-	for (const entry of Object.values(runnerOptions.workflows)) workflowsByName.set(entry.name, entry);
-	const runtime = runnerOptions.runtime;
-	const time = runtime.time;
-	const runnerId = runnerOptions.runnerId ?? runtime.random.uuid();
-	const leaseMs = runnerOptions.leaseMs ?? DEFAULT_LEASE_MS;
-	const getDbNow = runnerOptions.getDbNow ?? (async () => {
-		const services = runnerOptions.fragment.services;
-		if (services.getDbNow) return services.getDbNow();
-		return time.now();
-	});
-	const runHandlerTxForRunner = (callback) => runHandlerTx(runnerOptions.fragment, callback);
-	const workflowBindings = createWorkflowsBindingsForRunner({
-		workflows: runnerOptions.workflows,
-		fragment: runnerOptions.fragment
-	});
-	const claimTaskForRunner = (task, now) => claimTask(task, now, {
-		runHandlerTx: runHandlerTxForRunner,
-		time,
-		runnerId,
-		leaseMs,
-		getDbNow
-	});
-	const commitInstanceAndTaskForRunner = (task, instance, status, update, taskAction, mutations) => commitInstanceAndTask(task, instance, status, update, taskAction, mutations, {
-		runHandlerTx: runHandlerTxForRunner,
-		time,
-		getDbNow
-	});
-	const deleteTaskForRunner = (task) => deleteTask(task, { runHandlerTx: runHandlerTxForRunner });
-	const startTaskLeaseHeartbeatForRunner = (task, state) => startTaskLeaseHeartbeat(task, state, {
-		runHandlerTx: runHandlerTxForRunner,
-		time,
-		runnerId,
-		leaseMs,
-		getDbNow
-	});
-	return { async tick(tickOptions = {}) {
-		const now = await getDbNow();
-		const maxInstances = tickOptions.maxInstances ?? DEFAULT_MAX_INSTANCES;
-		const maxSteps = tickOptions.maxSteps ?? DEFAULT_MAX_STEPS;
-		const [pendingTasks, expiredProcessingTasks] = await runHandlerTxForRunner((handlerTx) => handlerTx().retrieve(({ forSchema }) => forSchema(workflowsSchema).find("workflow_task", (b) => b.whereIndex("idx_workflow_task_status_runAt", (eb) => eb.and(eb("status", "=", "pending"), eb("runAt", "<=", now))).orderByIndex("idx_workflow_task_status_runAt", "asc").pageSize(maxInstances * 3)).find("workflow_task", (b) => b.whereIndex("idx_workflow_task_status_lockedUntil", (eb) => eb.and(eb("status", "=", "processing"), eb("lockedUntil", "<=", now))).orderByIndex("idx_workflow_task_status_lockedUntil", "asc").pageSize(maxInstances * 3))).transformRetrieve(([pending, expired]) => [pending, expired]).execute());
-		const tasksById = /* @__PURE__ */ new Map();
-		for (const task of pendingTasks) tasksById.set(String(task.id), task);
-		for (const task of expiredProcessingTasks) tasksById.set(String(task.id), task);
-		const tasks = Array.from(tasksById.values());
-		tasks.sort((a, b) => {
-			const priorityA = PRIORITY_BY_KIND[a.kind] ?? 9;
-			const priorityB = PRIORITY_BY_KIND[b.kind] ?? 9;
-			if (priorityA !== priorityB) return priorityA - priorityB;
-			return a.runAt.getTime() - b.runAt.getTime();
-		});
-		let processed = 0;
-		for (const task of tasks) {
-			if (processed >= maxInstances) break;
-			const claimed = await claimTaskForRunner(task, now);
-			if (!claimed) continue;
-			processed += await processTask(claimed, maxSteps, {
-				time,
-				getDbNow,
-				workflowsByName,
-				workflowBindings,
-				commitInstanceAndTask: commitInstanceAndTaskForRunner,
-				deleteTask: deleteTaskForRunner,
-				startTaskLeaseHeartbeat: startTaskLeaseHeartbeatForRunner
-			});
-		}
-		return processed;
-	} };
-}
-
-//#endregion
-export { createWorkflowsRunner };
-//# sourceMappingURL=runner.js.map

package/dist/node/runner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runner.js","names":["runHandlerTxForRunner: RunHandlerTx"],"sources":["../../src/runner.ts"],"sourcesContent":["// Workflow runner entry point that wires helpers together and drives task ticks.\n\nimport type { RunnerTickOptions, WorkflowsRegistry, WorkflowsRunner } from \"./workflow\";\nimport { createWorkflowsBindingsForRunner } from \"./bindings-runner\";\nimport { workflowsSchema } from \"./schema\";\nimport {\n  DEFAULT_LEASE_MS,\n  DEFAULT_MAX_INSTANCES,\n  DEFAULT_MAX_STEPS,\n  PRIORITY_BY_KIND,\n} from \"./runner/constants\";\nimport { runHandlerTx } from \"./runner/queries\";\nimport {\n  claimTask,\n  deleteTask,\n  startTaskLeaseHeartbeat,\n  commitInstanceAndTask,\n} from \"./runner/task\";\nimport { processTask } from \"./runner/process\";\nimport type { RunHandlerTx, WorkflowsRunnerOptions, WorkflowTaskRecord } from \"./runner/types\";\n\n// General flow:\n// 1) find runnable tasks and expired leases\n// 2) claim tasks with a lease\n// 3) load instance + workflow, run steps, and persist buffered state\n// 4) reschedule or complete tasks based on the outcome\nexport function createWorkflowsRunner(runnerOptions: WorkflowsRunnerOptions): WorkflowsRunner {\n  const workflowsByName = new Map<string, WorkflowsRegistry[keyof WorkflowsRegistry]>();\n  for (const entry of Object.values(runnerOptions.workflows)) {\n    workflowsByName.set(entry.name, entry);\n  }\n\n  const runtime = runnerOptions.runtime;\n  const time = runtime.time;\n  const runnerId = runnerOptions.runnerId ?? runtime.random.uuid();\n  const leaseMs = runnerOptions.leaseMs ?? DEFAULT_LEASE_MS;\n  const getDbNow =\n    runnerOptions.getDbNow ??\n    (async () => {\n      const services = runnerOptions.fragment.services as { getDbNow?: () => Promise<Date> };\n      if (services.getDbNow) {\n        return services.getDbNow();\n      }\n      return time.now();\n    });\n\n  const runHandlerTxForRunner: RunHandlerTx = (callback) =>\n    runHandlerTx(runnerOptions.fragment, callback);\n\n  const workflowBindings = createWorkflowsBindingsForRunner({\n    workflows: runnerOptions.workflows,\n    fragment: runnerOptions.fragment,\n  });\n\n  const claimTaskForRunner = (task: WorkflowTaskRecord, now: Date) =>\n    claimTask(task, now, {\n      runHandlerTx: runHandlerTxForRunner,\n      time,\n      runnerId,\n      leaseMs,\n      getDbNow,\n    });\n\n  const commitInstanceAndTaskForRunner = (\n    task: WorkflowTaskRecord,\n    instance: Parameters<typeof commitInstanceAndTask>[1],\n    status: Parameters<typeof commitInstanceAndTask>[2],\n    update: Parameters<typeof commitInstanceAndTask>[3],\n    taskAction: Parameters<typeof commitInstanceAndTask>[4],\n    mutations: Parameters<typeof commitInstanceAndTask>[5],\n  ) =>\n    commitInstanceAndTask(task, instance, status, update, taskAction, mutations, {\n      runHandlerTx: runHandlerTxForRunner,\n      time,\n      getDbNow,\n    });\n\n  const deleteTaskForRunner = (task: WorkflowTaskRecord) =>\n    deleteTask(task, { runHandlerTx: runHandlerTxForRunner });\n\n  const startTaskLeaseHeartbeatForRunner = (\n    task: WorkflowTaskRecord,\n    state: Parameters<typeof startTaskLeaseHeartbeat>[1],\n  ) =>\n    startTaskLeaseHeartbeat(task, state, {\n      runHandlerTx: runHandlerTxForRunner,\n      time,\n      runnerId,\n      leaseMs,\n      getDbNow,\n    });\n\n  return {\n    async tick(tickOptions: RunnerTickOptions = {}) {\n      const now = await getDbNow();\n      const maxInstances = tickOptions.maxInstances ?? DEFAULT_MAX_INSTANCES;\n      const maxSteps = tickOptions.maxSteps ?? DEFAULT_MAX_STEPS;\n\n      const [pendingTasks, expiredProcessingTasks] = await runHandlerTxForRunner((handlerTx) =>\n        handlerTx()\n          .retrieve(({ forSchema }) =>\n            forSchema(workflowsSchema)\n              .find(\"workflow_task\", (b) =>\n                b\n                  .whereIndex(\"idx_workflow_task_status_runAt\", (eb) =>\n                    eb.and(eb(\"status\", \"=\", \"pending\"), eb(\"runAt\", \"<=\", now)),\n                  )\n                  .orderByIndex(\"idx_workflow_task_status_runAt\", \"asc\")\n                  .pageSize(maxInstances * 3),\n              )\n              .find(\"workflow_task\", (b) =>\n                b\n                  .whereIndex(\"idx_workflow_task_status_lockedUntil\", (eb) =>\n                    eb.and(eb(\"status\", \"=\", \"processing\"), eb(\"lockedUntil\", \"<=\", now)),\n                  )\n                  .orderByIndex(\"idx_workflow_task_status_lockedUntil\", \"asc\")\n                  .pageSize(maxInstances * 3),\n              ),\n          )\n          .transformRetrieve(([pending, expired]) => [pending, expired])\n          .execute(),\n      );\n\n      const tasksById = new Map<string, WorkflowTaskRecord>();\n      for (const task of pendingTasks) {\n        tasksById.set(String(task.id), task);\n      }\n      for (const task of expiredProcessingTasks) {\n        tasksById.set(String(task.id), task);\n      }\n      const tasks = Array.from(tasksById.values());\n\n      tasks.sort((a, b) => {\n        const priorityA = PRIORITY_BY_KIND[a.kind] ?? 9;\n        const priorityB = PRIORITY_BY_KIND[b.kind] ?? 9;\n        if (priorityA !== priorityB) {\n          return priorityA - priorityB;\n        }\n        return a.runAt.getTime() - b.runAt.getTime();\n      });\n\n      let processed = 0;\n      for (const task of tasks) {\n        if (processed >= maxInstances) {\n          break;\n        }\n        const claimed = await claimTaskForRunner(task, now);\n        if (!claimed) {\n          continue;\n        }\n        processed += await processTask(claimed, maxSteps, {\n          time,\n          getDbNow,\n          workflowsByName,\n          workflowBindings,\n          commitInstanceAndTask: commitInstanceAndTaskForRunner,\n          deleteTask: deleteTaskForRunner,\n          startTaskLeaseHeartbeat: startTaskLeaseHeartbeatForRunner,\n        });\n      }\n\n      return processed;\n    },\n  };\n}\n"],"mappings":"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"}