| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354 |
- """Which cron execution the current code runs inside, for plugins (``ctx.current_cron_execution()``).
- The scheduler binds it once it has won the execution's ``claimed`` → ``running`` transition (or a
- restart-safe worker adopted it) and resets it when the fire ends. It is a ContextVar, so it follows
- the agent onto the threads the scheduler already runs it on via ``contextvars.copy_context()`` and
- never leaks to another concurrently firing job or profile. Model output cannot reach it: tool
- subprocesses do not share the interpreter. Delegated children read ``None`` — they are not the
- scheduled occurrence.
- """
- from __future__ import annotations
- from contextvars import ContextVar, Token
- from dataclasses import dataclass
- from typing import Any, Mapping, Optional
- @dataclass(frozen=True)
- class CronExecution:
- job_id: str
- job_name: str
- execution_id: str
- source: str # "builtin" (ticker), "direct" (manual run / dashboard Run now), provider name...
- scheduled_instant: Optional[str] # the occurrence fired; None for an off-schedule run
- started_at: Optional[str]
- profile: str
- _CURRENT: ContextVar[Optional[CronExecution]] = ContextVar("hermes_cron_execution", default=None)
- def enter_cron_execution(job: Mapping[str, Any], execution_id: str, record: Mapping[str, Any]) -> Token:
- """Bind this fire's identity from *record*, the ledger row of the running transition."""
- from hermes_cli.profiles import current_profile_name
- return _CURRENT.set(CronExecution(
- job_id=str(job["id"]),
- job_name=str(job.get("name") or job["id"]),
- execution_id=str(execution_id),
- source=str(record.get("source") or ""),
- scheduled_instant=record.get("scheduled_instant"),
- started_at=record.get("started_at"),
- profile=current_profile_name("default") or "default",
- ))
- def exit_cron_execution(token: Optional[Token]) -> None:
- if token is not None:
- _CURRENT.reset(token)
- def current_cron_execution() -> Optional[CronExecution]:
- from agent.delegation_context import is_delegated_child_context
- return None if is_delegated_child_context() else _CURRENT.get()
|