Enum TaskEvent 

pub enum TaskEvent {
    GoalSet {
        at: DateTime<Utc>,
        objective: String,
        success_criteria: Vec<String>,
        forbidden: Vec<String>,
        source_session_id: String,
        source_turn_id: String,
        source_text_hash: String,
        source_kind: GoalSourceKind,
        confidence: f32,
    },
    GoalReaffirmed {
        at: DateTime<Utc>,
        progress_note: String,
    },
    GoalCleared {
        at: DateTime<Utc>,
        reason: String,
    },
    TaskAdded {
        at: DateTime<Utc>,
        id: String,
        content: String,
        parent_id: Option<String>,
    },
    TaskStatus {
        at: DateTime<Utc>,
        id: String,
        status: SessionTaskStatus,
        note: Option<String>,
    },
    DriftDetected {
        at: DateTime<Utc>,
        tool_calls_since_reaffirm: u32,
        errors_since_reaffirm: u32,
    },
}

A single durable event in the session task log.

TaskEvent is the append-only record format for session goal governance and task lifecycle tracking. Each variant captures one fact that happened at a specific UTC timestamp. The current materialized task state is reconstructed by replaying these events in order, rather than by editing earlier records.

Events are serialized with an internally tagged Serde representation. The kind field stores the variant name in snake_case, which keeps persisted JSONL task logs readable and stable across releases.

Variants

GoalSet

Declares or replaces the active session goal.

A goal contains the objective the agent should pursue, optional completion criteria, explicit forbidden behaviors, and provenance fields describing where the objective came from. When this event is folded into task state, it supersedes any previously active goal.

Fields

at: DateTime<Utc>

Time at which the goal was declared.

objective: String

Human-readable objective the agent should work toward.

success_criteria: Vec<String>

Criteria that indicate the objective has been satisfied.

Defaults to an empty list when omitted by older log entries or simple goal-setting paths.

forbidden: Vec<String>

Actions or behaviors that are explicitly out of scope.

Defaults to an empty list when no additional forbidden behaviors were recorded.

source_session_id: String

Identifier of the session containing the source evidence for this goal.

Empty when the producer did not capture a source session.

source_turn_id: String

Turn identifier or turn index within the source session.

Empty when the goal is not anchored to a specific raw transcript turn.

source_text_hash: String

Hash of the source text used to derive the goal.

This allows provenance comparisons without duplicating the full source text in every event.

source_kind: GoalSourceKind

Category describing how the goal was derived.

Consumers can use this to distinguish strong provenance, such as raw transcript turns or direct user input, from weaker provenance, such as summarized recall, durable memory, or inference.

confidence: f32

Producer-supplied confidence in the recorded provenance.

1.0 means the goal is directly supported by the recorded source evidence. 0.0 means no confidence was supplied or the goal should be treated as unverified.

GoalReaffirmed

Records that the agent reaffirmed alignment with the active goal.

Reaffirmation does not change the objective. It stores a progress note so governance logic can reset drift counters and later explain why work continued.

Fields

at: DateTime<Utc>

Time at which the reaffirmation was recorded.

progress_note: String

Concise statement of completed work, remaining work, or the current blocker.

GoalCleared

Clears the active session goal.

Folding the log after this event leaves the session without an active goal until a later TaskEvent::GoalSet appears.

Fields

at: DateTime<Utc>

reason: String

TaskAdded

Adds a task to the session task list.

Added tasks start as pending in folded state. Later TaskEvent::TaskStatus events update tasks by matching the id field.

Fields

at: DateTime<Utc>

Time at which the task was added.

id: String

Stable identifier for this task within the session task log.

content: String

Human-readable task description.

parent_id: Option<String>

Optional parent task identifier for nested task breakdowns.

Defaults to None for top-level tasks and older log entries.

TaskStatus

Updates the lifecycle status of an existing task.

Folding logic applies this transition to the task with the matching id when that task exists in the materialized task map. The event remains in the append-only log even if the task is missing.

Fields

at: DateTime<Utc>

Time at which the status transition was recorded.

id: String

Identifier of the task being updated.

status: SessionTaskStatus

New lifecycle status for the task.

note: Option<String>

Optional note explaining the transition, such as a blocker, cancellation reason, or completion summary.

DriftDetected

Records that governance detected possible drift from the active goal.

Drift events preserve the counters that triggered an alignment warning, allowing later inspection to understand why the agent was asked to reaffirm the goal or stop before continuing.

Fields

at: DateTime<Utc>

Time at which drift was detected.

tool_calls_since_reaffirm: u32

Number of tool calls since the last goal reaffirmation.

errors_since_reaffirm: u32

Number of errors since the last goal reaffirmation.

Trait Implementations

impl Clone for TaskEvent

fn clone(&self) -> TaskEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TaskEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.