Struct Trigger 

pub struct Trigger {

    pub name: String,
    pub schedule: Schedule,
    pub prompt: String,
    pub description: Option<String>,
    pub timezone: Option<String>,
    pub enabled: bool,
    pub created_at: Option<DateTime<Utc>>,
    pub provider: Option<String>,
    pub model: Option<String>,
    pub workspace: Option<PathBuf>,
    pub permission_mode: PermissionMode,
    pub tools: Vec<String>,
    pub no_mcp: bool,
    pub max_turns: Option<u32>,
    pub max_output_tokens: Option<u64>,
    pub max_cost_usd: Option<f64>,
    pub timeout: Option<String>,
    pub catch_up: CatchUp,
    pub notify: Option<String>,
}

One scheduled prompt.

Fields

name: String

The file’s stem. Never read from the file itself — a name that can disagree with its filename is a class of bug with no upside.

schedule: Schedule

Five-field cron, in timezone.

prompt: String

What to ask. This is the whole action: a trigger runs an agent, not a command. (Scheduled commands are what cron is for, and giving one a place in this store would mean answering how it gets confined and which environment it sees — questions the MCP and sandbox work already answered the expensive way.)

description: Option<String>

One line for mecha trigger list.

timezone: Option<String>

IANA name. Written explicitly by mecha trigger add, resolved from [agent] timezone at the time: “07:00” must not quietly mean something different after a config edit.

enabled: bool

created_at: Option<DateTime<Utc>>

The anchor for the first fire. Without it a trigger added at 08:00 would find 07:00 unfired and run immediately.

provider: Option<String>

model: Option<String>

workspace: Option<PathBuf>

The path jail for this run. Defaults to the daemon’s working directory, which is usually not what you want — say it.

permission_mode: PermissionMode

Read-only by default. See the module docs: an unattended run has nobody to ask, and outbox staging works at every level.

tools: Vec<String>

Only these tools, if set. The narrowest useful control there is: a briefing that can read mail and nothing else cannot be talked into anything else.

no_mcp: bool

Skip MCP servers entirely for this run.

max_turns: Option<u32>

max_output_tokens: Option<u64>

max_cost_usd: Option<f64>

Needs prices on the provider. A cap that cannot fire is refused at load rather than ignored at 03:00 — see Trigger::validate.

timeout: Option<String>

Wall-clock ceiling on one run. Cancels at the next safe point, keeping the partial answer, exactly as Ctrl-C does.

catch_up: CatchUp

notify: Option<String>

A command run when the trigger produces an answer, with the answer on stdin — notify-send, a mail invocation, an append to a file.

An observer, like post_tool: its failure is logged and never fails the run. The answer is already in the session transcript, which is the record; this is delivery.

Implementations

impl Trigger

pub fn new( name: impl Into<String>, schedule: Schedule, prompt: impl Into<String>, ) -> Self

pub fn valid_name(name: &str) -> Result<()>

A trigger name is a filename, a log line, and a CLI argument. Keep it to what is unambiguous in all three.

pub fn validate(&self) -> Result<()>

Everything that can be wrong with a trigger before it ever runs.

Called on load, so a typo surfaces on mecha trigger list at a keyboard, not on the fire it was meant to control.

pub fn tz(&self, fallback: Option<Tz>) -> Tz

The zone its wall-clock schedule is read in.

pub fn timeout_duration(&self) -> Duration

pub fn next_fire( &self, at: DateTime<Utc>, fallback_tz: Option<Tz>, ) -> Option<DateTime<Utc>>

When this trigger would next fire after at.

pub fn due( &self, last_slot: Option<DateTime<Utc>>, now: DateTime<Utc>, fallback_tz: Option<Tz>, ) -> Due

Is it due, and if not, when?

last_slot is the most recent slot that has already been accounted for — fired, or deliberately skipped. None means nothing has, in which case created_at is the anchor: a trigger must not fire for a slot that predates its own existence.

Trait Implementations

impl Clone for Trigger

fn clone(&self) -> Trigger

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Trigger

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Trigger

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Trigger

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.