triggers

triggers

Trigger types for the distillation subsystem.

A trigger is what kicks off a learning session. Four trigger types exist, all funneling into DistillationOrchestrator.run(trigger). The trigger object is stored on the LearningSession for queryability.

See spec §3.3.

Classes

OnDemandTrigger dataclass

OnDemandTrigger(kind: TriggerKind = ON_DEMAND, metadata: dict[str, Any] = dict())

User ran jarvis learning run from the CLI.

UserFlagTrigger dataclass

UserFlagTrigger(trace_id: str = '', kind: TriggerKind = USER_FLAG)

User flagged a specific trace for improvement.

ScheduledTrigger dataclass

ScheduledTrigger(cron: str = '0 3 * * *', new_trace_count: int = 0, kind: TriggerKind = SCHEDULED)

Cron-based scheduled trigger.

ClusterTrigger dataclass

ClusterTrigger(cluster_description: str = '', trace_ids: list[str] = list(), failure_rate: float = 0.0, kind: TriggerKind = CLUSTER)

Fired when a failure cluster exceeds a threshold.