job_definition.py 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. """Job-definition schema shared by importers of a foreign cron store.
  2. Cron owns which persisted fields are *authored* (create_job) versus *advanced by the
  3. scheduler* (next_run_at, state, run counters...). Callers merging an authored store
  4. into a live one (profile distributions) import this rather than duplicating the list.
  5. """
  6. from typing import Any, Dict
  7. from cron.jobs import _apply_schedule_update, _jobs_lock, is_job_runnable, load_jobs, parse_schedule, save_jobs
  8. from cron.quota_hold import clear_state as _clear_quota_hold
  9. from hermes_time import now as _hermes_now
  10. JOB_DEFINITION_FIELDS = frozenset({
  11. "name", "prompt", "skills", "skill", "model", "provider", "base_url",
  12. "script", "no_agent", "monitor_script", "monitor_url", "context_from",
  13. "schedule", "schedule_display", "deliver", "origin", "enabled_toolsets",
  14. "workdir", "attach_to_session", "reasoning_effort", "failure_deliver",
  15. "timezone", "grace_minutes", "catch_up",
  16. })
  17. def merge_job_definition(local: dict[str, Any], authored: dict[str, Any]) -> dict[str, Any]:
  18. """Refresh authored fields while preserving this store's scheduler-owned state.
  19. Raises ValueError when the authored schedule cannot be scheduled (unparseable string,
  20. past one-shot for a live job)."""
  21. merged = {key: value for key, value in local.items() if key not in JOB_DEFINITION_FIELDS}
  22. merged.update((key, authored[key]) for key in JOB_DEFINITION_FIELDS if key in authored)
  23. merged["repeat"] = {
  24. "completed": (local.get("repeat") or {}).get("completed", 0),
  25. "times": (authored.get("repeat") or {}).get("times"),
  26. }
  27. if isinstance(merged.get("schedule"), str):
  28. merged["schedule"] = parse_schedule(merged["schedule"])
  29. # A zone change moves every wall-clock occurrence exactly like an expr change: the instant on
  30. # file belongs to the old zone and the next scan would re-anchor past it without firing.
  31. if (local.get("schedule") != merged.get("schedule")
  32. or local.get("timezone") != merged.get("timezone")):
  33. merged.pop("pending_slot", None)
  34. _clear_quota_hold(merged)
  35. if is_job_runnable(merged):
  36. updates = {"schedule": merged["schedule"]}
  37. if "schedule_display" in authored:
  38. updates["schedule_display"] = authored["schedule_display"]
  39. _apply_schedule_update(merged, updates, str(merged.get("id") or "imported job"))
  40. else:
  41. merged["next_run_at"] = None
  42. return merged
  43. def import_job_definitions(shipped: dict[str, dict[str, Any]], *, paused_reason: str) -> None:
  44. """Merge *shipped* (job id -> authored record) into the active store under its lock.
  45. Unknown ids arrive with the marker set ``create_job(paused=True)`` writes; known ids keep
  46. their scheduler state. Nothing is written when a record cannot be merged: the ValueError
  47. is re-raised naming the job."""
  48. now = _hermes_now().isoformat()
  49. seed = {
  50. "enabled": False,
  51. "state": "paused",
  52. "paused_at": now,
  53. "paused_reason": paused_reason,
  54. "created_at": now,
  55. "next_run_at": None,
  56. }
  57. pending = dict(shipped)
  58. with _jobs_lock():
  59. merged = []
  60. for local in load_jobs():
  61. incoming = pending.pop(local.get("id"), None)
  62. merged.append(local if incoming is None else _merge_or_name(local, incoming))
  63. merged.extend(_merge_or_name({"id": job_id, **seed}, incoming) for job_id, incoming in pending.items())
  64. save_jobs(merged)
  65. def _merge_or_name(local: dict[str, Any], authored: dict[str, Any]) -> dict[str, Any]:
  66. try:
  67. return merge_job_definition(local, authored)
  68. except ValueError as exc:
  69. raise ValueError(f"cron job {authored.get('name') or local.get('id')!r}: {exc}") from exc